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PREFACE 



The Network Operating System (NOS) was developed by Control Data Corporation to provide network 
capabilities for time-sharing and transaction processing, in addition to local and remote batch processing 
on CONTROL DATA® CYBER 170 Series computer systems; CDC®CYBER 70 Series, Models 71, 72, 73, 
and 74 computer systems; and CDC 6000 Series computer systems. 



AUDIENCE 

This manual describes the external features of NOS 1.4. Information in this manual should be useful to 
those who use the programs and utilities supplied with the system and those who wish to write their own. 
The manual is contained in two volumes to separate information pertaining primarily to the applications 
user from that of interest to the applications COMPASS programmer. 

Volume 1 (publication number 60435400) is written for all NOS users. Users can understand the manual 
contents without knowing the COMPASS assembly language. However, they should read the NOS Batch 
User's Guide and/or the lAF User's Guide or NOS Time-Sharing User's Guide before reading this manual. 

Volume 2 (publication number 60445300) is written for the applications COMPASS programmer. It is 
assumed the user has an extensive knowledge of the COMPASS assembly language and the COMPASS 
Reference Manual. 



ORGANIZATION 

Volume 1 contains information for the applications programmer. This includes general information about 
files, job flow and execution, control statement processing, and an extensive discussion of control 
statements. 

Volume 2 contains information for those who write system or assembly language programs for use with 
NOS. 



CONVENTIONS 

Extended memory for the CYBER 170 Model 176 is large central memory extended (LCME). Extended 
memory for aU other NOS computer systems is extended core storage (ECS) or extended semiconductor 
memory (ESM). 

In this manual, the acronym ECS refers to all forms of extended memory unless otherwise noted. 

Programming information for the various forms of extended memory can be found in the COMPASS 
Reference Manual and in the appropriate computer system hardware reference manual. 
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Conventions for central memory word formats are as follows: 

• Cross-hatching indicates a field is not used by or is not applicable to a function processor. 
However, Control Data reserves the right to assign these fields to system use in the future. 

• Fields reserved for system use are so labeled. 

o Fields labeled with mnemonics indicate a specific parameter must be inserted (generally 
described after the word format). 

• Fields with numeric identifiers indicate the actual value that is used or returned for a particular 
function. Numeric identifiers are octal unless otherwise noted. 



RELATED PUBLICATIONS 

The NOS Manual Abstracts is a pocket-sized manual containing brief descriptions of the contents and 
intended audience of all NOS and NOS product manuals. The abstracts can be useful in determining 
which manuals are of greatest interest to a particular user. 

i Control Data also publishes a Software Publications Release History of all software manuals and revision 
packets it has issued. This history report lists the revision level of a particular manual that corresponds 
to the level of software installed at the site. 
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PROGRAM/SYSTEM COMMUNICATION 



The Network Operating System (NOS) allows communication between a CPU program and 
predefined system routines and functions as follows: 

• RA+1 system requests to function processors 

• NOS systems texts 

• Macrost 

• Common decks tt 

These routines enable the user to perform complex operations with a minimum of coding. 
They have been thoroughly tested and optimized, and are designed to interface with the 
system. 

FUNCTION PROCESSORS 

Several NOS system routines process user requests. Sections 3 through 11 contain descrip- 
tions of each function processor, including: 

• Identification of the requests (function numbers) 
o Systems texts required to issue the requests 

• System macros (or common decks containing macros) available to issue the 
requests 

• Common decks required to issue the requests 

• Information returned from the processor after the requests 

Following is a list of the NOS function processors whose system request formats are de- 
scribed in this manual. 

Processor Description Section 

ABT Exit processing request 11 

CIO Combined input /output 3 

CKP Checkpoint processor 10 

CPM Control point manager 6 

CVL Common validation interface 

processor 11 

DED, DEP Extended core storage dump 11 

DMD, DMP Central memory dump 11 

DSP File routing 8 



t Refer to the COMPASS Reference Manual for a complete description of how macros are 
defined and used, 
tt Refer to the Modify Reference Manual for a complete description of how common decks 
are defined and used. 
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Processor 

END 

LDD, LDQ 

LDR, LDV 

LFM 

MEM 

MSG 

PFM 

QFM 

RCL 

RFL 

RPV 

SFM 

TCS 

TIM 



Description 
Program termination request 
Fast dynamic loading 
Overlay request 
Local file manager 
Memory requests 
System message processor 
Permanent file manager 
Queue file manager 
Recall CPU 
Memory requests 
Reprieve processing 
System file manager 
Translate control statement 
Time and date functions 
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11 




11 
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11 




11 




5 




7 




11 




11 




10 




11 




10 
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SYSTEM REQUESTS 

All communication with the system is performed by entering a system request in location 1 
(RA+1) of the field length (refer to figure 2-E-l). The system then initiates execution of 
that portion of the system required to satisfy the user's request. There are two types of 
system requests. 

• Those that contain all information necessary in RA+1 (for example, RCL). 

• Those that require additional areas for parameters or results from the system 
[for example, CIO requires the specification of a file environment table (FET)]. 

The format of the 60-bit request is one of the following (depending on whether two or 
three parameters are to be passed). 



59 






40 


35 


23 




II 


fff 


'i 


r 


% 


P3 


P 


2 


Pf 


59 




40 35 




7 





fff 


I 


r 


%. 


P2 




P| 



fff System request name 

r Auto recall bit (pj^ must be specified) 

Pl»P2»P3 Parameters passed to the portion of the system that processes fff 

(pn in second format may contain two parameters) 
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SYSTEM REQUEST PROCESSING 

Whether a system request communicates with a FET or another parameter block, the first 
word of this area is usually the status word. Both the system and the user use the lower 
portion of this word to communicate the status of the request. When bit is cleared 
(equals 0), the system is in control of the request; when it is set (equals 1), the user is in 
control of the request. 

For example, to write on file ABC, the program must perform the following steps. 

1. Check the status (bit of the first word of the FET) of ABC. 

2. If ABC is busy (bit cleared), the program must wait until bit is set. This is 
done by issuing a system request to recall (RCL). 

3. When ABC is idle (bit set), the program must clear bit and place the request 
in RA+1. 

4. If other processing can be performed, the program proceeds. 

5. If further processing depends upon ABC being completed, the program must check 
the status word for completion (bit set by the system). 

To perform this write operation on file ABC, the user issues a system request to CIO. The 
following diagram illustrates the user/ system control when performing this operation. 



User Control of ABC 



System Control of ABC 



User Control of ABC 



RA+1 



CIO 



2000 -1 



2000 



RA+1 





2000 "-^ 




The user requests the system 
to take control of ABC by clear- 
ing bit of the status word and 
entering CIO 2000 Ln RA + 1. 



The system clears 
RA+ 1 upon begin- 
ning processing of 
the request. 



The system sets bit of the 
status word upon completing 
the request. 



In many situations, the program cannot proceed until the system request is complete (as 
in steps 2 and 5 when ABC is busy). When this occurs, the user can prevent execution 
until the status word is not busy (bit set). This simplifies the programmer's job, 
because he does not have to check the status. It also reduces the amount of CPU time 
used by the job. 
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In the previous example, if the following request is issued. 



RA+1 


CIOP 2000 


— 




















-> 






2000 


ABC 16 











P is the display code representation of the 
auto recall bit (20g); that is, bit 40 of RA+1 
is set. 



the system would not allow the job to continue execution until bit of word 2000 was 
set and the FPU completed its operation. 

The steps in this procedure are: 

1. Check the status of ABC. 

2. If ABC is busy, wait until bit is set and return to step 1. This can be done 
by issuing an RCLP function on word 2000. 

3. Clear bit of word 2000 and place the CIOP request in RA + 1. 

Processing can proceed with the assurance that the previous operation on ABC is com- 
pleted (bit of word 2000 does not have to be checked). 

The user should be aware that many system requests require that the auto recall bit be 
set. This is noted in the description of the requests, when necessary. 

ISSUING RA + 1 REQUESTS 

When a system request is placed in RA + 1, the system may process that request at any 
I time. The exchange jump instruction XJ, if available, provides much faster response 
to system requests. 

The system processes program requests by scanning location RA+1 of all user programs in 
the system. This is done on a periodic basis. If the system detects a request in RA+1 that 
can be processed, RA+1 is cleared and processing begins. 

When the user program issues a request, it must check RA+1 to determine if the request 
is accepted by the system before it issues another request. 

The following example illustrates the steps taken by the user and the system to process 
a system request. 

1. The user issues a CIO request on word 2000 to RA + 1 (CIO 2000). 

2. The user proceeds with his processing. 

3. The user now wishes to wait until the request is complete before continuing. 
He does this by issuing an RCLP request on word 2000. However, he must 
first check RA + 1 to ensure that the request to CIO is accepted before he issues 
the RCLP request. 
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The system performs the following steps in processing this user request. 
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(until 2000 
is complete) 

When the XJ instruction is available, the user places the system request in RA+1 and 
executes an XJ instruction. This causes the CPU to be exchanged to the system program 
CPUMTR from the user's program. The system can act upon the request immediately. 

When the system initiates processing of the request, CPU control returns to the user, 
unless the request is made with auto recall. 

The user can determine whether the XJ instruction is available by checking if bit 59 of 
word 66 (XJPR) of his field length is set (refer to SYSCOM macro and figure 2-E-l). 

If the request in the previous example is performed in this manner, the following steps 
apply. 

1. The user places the CIO request on word 2000 in RA+1 and executes an XJ 
instruction. The central processor is reassigned to the job when the request 
is accepted. 

2. The user proceeds with his processing. 

3. The user now wishes to wait until this request is completed before continuing. 
This is done by placing the request RCLP 2000 in RA+1 and issuing another XJ 
instruction. It is not necessary to determine if the previous request is 
accepted. 

Many macros and common decks are provided to assist the programmer in performing 
this interaction with the system. 
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NOS SYSTEMS TEXTS 

The following systems texts are available to the NOS user. 

• SYSTEXT 

• PPTEXT 

• NOSTEXT 

• PSSTEXT 

• ECSTEXT 

Although other systems texts exist, the macros described in this manual are supported 
only in the systems texts listed above. 

SYSTEXT contains system communication macros that are used by the CPU COMPASS pro- 
I grammer. PPTEXT contains symbol definitions used by all system routines for inter- 
communication. NOSTEXT contains all system commiunication macros and symbol defini- 
tions that are found in SYSTEXT and PPTEXT. 

PSSTEXT contains macros that are defined on system OPL common decks COMCMAC and 
COMCCMD (refer to Common Deck Usage in this section and to appendix A). 

ECSTEXT contains operation definitions that are defined on common deck COMCECM. 
These definitions provide instructions for interpretive mode reading and writing of ECS 
(refer to appendix D). 

By selecting the correct systems text (for the applications COMPASS programmer, this 
usually will be SYSTEXT and/or PSSTEXT), the user can reduce the amount of system 
resources needed for assemblies. 

To obtain listings of the systems texts, enter one or more of the following control state- 
ments after accessing the system OPL.^ 

MODIFY(Q, CL, CS = 0, Z)/=!^EDIT, SYSTEXT 
MODIFY(Q, CL, CS=0, Z)/*EDIT, PPTEXT 
MODIFY(Q, CL, CS=0, Z)/-EDIT, NOSTEXT 
MODIFY(Q, CL, Z)/*EDIT, ECSTEXT 

To obtain a listing of PSSTEXT, enter the following statements after accessing the system 
OPL. 

MODIFY(Z)/=!^EDIT, PSSTEXT 
COMPASS (I,LO=X) 



MACRO USAGE 

Macros are available for issuing most requests to the function processors. If macros are 
not available, the user can define them. 
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A macro is a predefined sequence of COMPASS statements that can be used in the user's 
programs, t If the user wishes to use predefined macros, he may do so by specifying the 
location of these definitions to COMPASS with the S or G parameter. For example: 

COMPASSd, B, S=XYZTEXT) 

This call causes all macro definitions in XYZTEXT to be available for assem.bly of the pro- 
gram. If no S parameter is specified, COMPASS uses the system default system text 
SYSTEXT. In the descriptions in this manual, unless otherwise noted, all macros are 
defined in SYSTEXT and NOSTEXT. 

Some macros are defined in common decks; therefore, the common deck must be called into 
the text of the program (refer to Common Deck Usage)." If the decks are named COMCMAC 
or COMCCMD, the user has the option of specifying the alternate systems text PSSTEXT. 
For example: 

COMPASSd, B, S, S=PSSTEXT) 

This makes available all macro definitions in PSSTEXT (that is, those defined in common 
decks COMCMAC and COMCCMD) as well as all macros in SYSTEXT for the assembly of | 
the program. 

In addition to the macros available in SYSTEXT, an integer divide operation definition is 
provided for the user's convenience. Its format is as follows: 

IX i Xj/Xk 

The operation divides Xj by Xk and places the result in Xi. Registers Xj, Xk, and B7 are 
destroyed. 

When a macro parameter refers to an address, the parameter may be a register nam.e, 
a relocatable address, an external symbol, or an absolute address. The user should con- 
sult the expansions of the system macros to determine the optimum use of registers when 
using macros. The user is responsible for ensuring that a register used as a parameter 
contains only the parameter (for example, if an 18-bit address is specified by an X register, 
the user in some cases must ensure that the upper 42 bits of the register are zero). 

Most NOS system macros and common decks preserve the contents of the following registers. 

AO, XO, A5, and X5 

Also, upon exit, the contents of registers Bl and X2 are as follows: 

Bl 1 

X2 FET address (refer to section 2) if a macro specifies the FET address as a 
parameter 

There are exceptions to these rules and the user should refer to documentation of a miacro 
or common deck when in doubt. 

The contents of the Bl register is assumed to be 1 upon entry only if the SYSCOM Bl 
macro is called or the Bl = l COMPASS pseudo instruction is defined. 



t The COMPASS Reference Manual provides instructions for defining macros. 
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SYSCOM 

The SYSCOM macro performs the following functions. 

• Optionally defines the Bl = l COMPASS pseudo instruction 

• Defines system communication symbols 

If this macro is used, it should be set as an initial step in the program. 
Macro Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




SYSCOM 


Bl 



Bl 



If present, COMPASS pseudo instruction Bl = l is defined 



Many system common decks called from macros assume the contents of the Bl register is 
equal to 1. Other common decks assume Bl is equal to 1 only if the macro SYSCOM Bl or 
COMPASS pseudo instruction Bl = l is defined. If the Bl parameter is not included in the 
SYSCOM call or if there is no SYSCOM call, these common decks then generate additional 
code to set Bl equal to 1. If SYSCOM Bl or the Bl = l pseudo instruction is used, it is the 
user's responsibility to set the Bl register equal to 1. 

The specification of SYSCOM (with or without specifying Bl) also makes available the sys- 
tem communication symbols (refer to figure 2-E-l). These are: 



Symbol 



LWPR 



Value 



RA.MTR 


1 


ARGR 


2 


SPPR 


2^8 


PGNR 


6^8 


ACTR 


^h 


CMUR, 
RA.CMU 


663 



65, 



FWPR 


66 


JOPR 


66 


XJPR, 


66 


RA.CEJ 




CSMR 


67 


LDRR 


67 


CCDR 


70 


LINP 


60 



10 



Description 

Address of RA + 1. 

Address of the first argument. 

Special program parameter area (locations 27o 
through 47g). 

Program name (bits 59 through 18). 

Argument count (bits 17 through 0). 

Compare /move unit (CMU) available flag (bit 59). 

LWA + 1 of the assigned program space (bits 17 
through 0). If Common Memory Manager is loaded 
in the user's field length, bits 17 through contain 
the complement of the LWA+1 of the assigned pro- 
gram space (refer to the Common Memory Man- 
ager Reference Manual). 

FWA of the assigned program space (bits 17 
through 0). 

Job origin type (bits 3 5 through 24). 

Central exchange available (bit 59). 

System character set mode flag (bit 59); set if 
64-character set mode. 

LDR completion (bit 29). 

Control statement image (eight locations). 

Lines per page. Used to format output. 
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DUPLICT 



IDENT DUPLICT 
ENTRY DUPLICT 



QUAL$ 



EQU 



1 



SUPPRESS COMMON DECK QUALIFICATION 



THE «SPACE FILL NAME* COMMON DECK MUST BE QUALIFIED 
BECAUSE THE PROGRAM HAS A SUBROUTINE »SFN* AND THE 
PROGRAMMER DOES NOT WISH TO RENAME THE SUBROUTINE. 



DUPLICT 



DUPA 
DUPB 
DUPC 

DUPD 



* 

* 
* 

* 



SFN 



SB1 

SA1 

MXO 

SX5 

BX1 

RJ 

SA6 

SX1 

RJ 

SB2 

RJ 

SA6 



1 

DUPA 

-18 

X1 + 

X0*X1 

/SFILL/SFN' 

DUPC 

X5+ 

CDD 

3 

SFN- 



ENTRY 

SET SYMBOL NAME IN MESSAGE 
CLEAR VALUE PORTION OF WORD 
SAVE VALUE 



SPACE FILL WORD 



CONVERT VALUE 



Transfers control to 
COMCSFN, qualified 
by SFILL 



SHIFT VALUE 3 CHARACTERS LEFT 



DUPD 
MESSAGE DUPB, ,R 
ENDRUN 



ISSUE MESSAGE 



Transfers control to 
the user's shift 
register routine, SFN 



CON OLNAME+1 23456 

CON 10H SYMBOL 

CON SYMBOL NAME 

CON 10HHAS VALUE 

CON CONVERTED SYMBOL VALUE 

CON MESSAGE TERMINATOR 

SPACE 4,10 

SFN - SHIFT REGISTER BY »N* CHARACTERS. 

ENTRY (X6) = REGISTER TO SHIFT. 

(B2) = NUMBER OF CHARACTERS TO SHIFT. 

EXIT (X6) = SHIFTED LEFT. 



ENTRY/EXIT 

SET NUMBER OF BITS TO SHIFT 



USES 


B - 2. 




X - 6, 7. 


SPACE 


4,10 


PS 




SX7 


B2 


SB2 


B2+B2 


LX7 


2 


SB2 


B2+X7 


LX6 


X6,B2 


JP 


SFN 



SHIFT REGISTER 
RETURN 



COMMON DECKS. 



«CALL 


COMCSYS 


*CALL 


COMCCDD 




QUAL SFILL 


*CALL 


COMCSFN 




SPACE 4,10 




END DUPLICT 



QUALIFY *SFN* 
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The QUAL$ tag can also be used to suppress the qualification of common decks called more 
than once in separate overlays. In the following example, the QUAL pseudo-instruction is 
used in each of the two primary overlays; the symbol QUAL$ is used to allow a copy of 
COMCCDD in each overlay without symbol conflicts. 



OVER 



IDENT MAIN, MAIN, MAIN 

ABS 

TITLE MAIN (0,0) OVERLAY. 

ORG 11 OB 



MAIN (0,0) OVERLAY 



QUAL$ 



EQU 



1 



SUPPRESS COMMON DECK QUALIFICATION 



f LOAD TWO OVERLAYS - ONE AT A TIME - EACH WILL USE 
^ ITS OWN COPY OF *CDD*, BUT WILL USE »SYS=* AND 

^ *MSG=* THAT RESIDE IN THE (0,0) OVERLAY. 

MAIN MESSAGE MAIA,,R * MAIN RUNNING.* 

SB1 1 

OVERLAY MAIB,0100B LOAD »0VL1» OVERLAY 

SB2 XI EXECUTE *0VL1* 

JP B2 

MAI1 OVERLAY MAIB,0200B LOAD *0VL2* OVERLAY 

SB2 XI EXECUTE *0VL2* 

JP B2 

MAI2 MESSAGE MAIC , , R » MAIN COMPLETE.* 

ENDRUN END 



MAIA DIS ,* MAIN RUNNING.* 

MAIB CON OLLGO OVERLAY FILE NAME 

MAIC DIS ,* MAIN COMPLETE.* 

»CALL COMCSYS 
»CALL COMCOVL 

OVER BSS a OVERLAY AREA BASE 

TTL PRIMARY (1,0) OVERLAY. 
EJECT 

QUAL 0VL1 DEFINE QUALIFICATION FOR THIS OVERLAY 

IDENT OVL 1,0V 1,0V 1,1,0 PRIMARY (1,0) OVERLAY 

ORG OVER START AT OVERLAY AREA 



2-1-14 



60445300 M 



READ THE REAL TIME CLOCK AND ISSUE A DAYFILE MESSAGE 
INDICATING WHEN OVERLAY WAS CALLED. 



0V1 


RTIME 


0V1A 


GET CURRENT TIME 




SA1 


0V1A 


CONVERT MILLISECONDS TO DI 




MXO 


-36 






BX1 


-X0»X1 






RJ 


CDD 






SA6 


OVIC 






MESSAGE 0V1B, ,R 


* 0VL1 CALLED AT NNNNNN» 




JP 


MAI1 


RETURN 


0V1A 


CON 





REAL TIME CLOCK 


0V1B 


DATA 


2 OH 0VL1 


CALLED AT 


OVIC 


CON 





CONVERTED MILLISECONDS 




CON 





MESSAGE TERMINATOR 


CALL 


COMCCDD 





TTL PRIMARY (2,0) OVERLAY. 

EJECT 

QUAL 0VL2 DEFINE QUALIFICATION FOR THIS OVERLAY 

IDENT OVL2,OV2,OV2,2,0 PRIMARY (2,0) OVERLAY 

ORG OVER START AT OVERLAY AREA 



READ THE REAL TIME CLOCK AND ISSUE A DAYFILE MESSAGE 
INDICATING WHEN OVERLAY WAS CALLED. 



0V2 RTIME 0V2A 

SA1 0V2A 

MXO -36 

BX1 -X0»X1 

RJ CDD 

SA6 0V2C 
MESSAGE 0V2B, ,R 

JP MAI2 



GET CURRENT TIME 

CONVERT MILLISECONDS TO DISPLAY CODE 



* 0VL2 CALLED AT 
RETURN 



NNNNNN* 



0V2A CON REAL TIME CLOCK 

0V2B DATA 20H 0VL2 CALLED AT 

0V2C CON CONVERTED MILLISECONDS 

CON MESSAGE TERMINATOR 



*CALL 



COMCCDD 
END 
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SECURITY CONSIDERATIONS 

A program cannot dump or directly change the job field length with an RA+1 request 
if the program is one of the following types. 

• A protected system program. 

• A user's program that has requested protection through the SETSSM macro (refer 
to section 6). 

• A user's program loaded from an execute only file. 

These security restrictions do not apply if the job is of system origin or if the user is 
validated for system origin privileges and DEBUG mode has been set on the system console. 

The following RA+1 calls can either dump or change central memory and therefore are not 
allowed when memory protection is requested (Secure System Memory status is set): 

Call Description 

CKP Checkpoint request 

DEP Dump ECS field length request 

DED Dump ECS field length request with display code 

DMP Dump field length request 

DMD Dump field length request with display code 

REQ Request equipment assignment 

LFM For the ASSIGN, LABEL, and REQUEST functions (refer to section 4) 

PFM For any access to removable auxiliary devices (refer to section 5) 

Violation of these restrictions results in the job step being aborted and the following 
dayfile message being issued. 

SECURE MEMORY, DUMP DISABLED. 

Refer to section 3, volume 1, for a list of control statements that cannot follow job 
steps with SSM status set. 
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FILE ENVIRONMENT TABLE (FET) 



This section describes the file communication area necessary for file creation and the 
processing of many user requests. The file environment table (FET) is the standard 
comm.unication area or parameter block for the system file processors. The COMPASS 
programmer must define the FET, whereas the higher level languages (COBOL and 
FORTRAN, for example) autom.atically establish and use this area. 

Depending on the processor being used, certain areas of the FET must be defined and 
used in communicating with that processor. The minim.um length of a FET is five 
words. 



CIRCULAR BUFFERS 

The buffer parameters (FIRST, IN, OUT, and LIMIT) in the FET describe the circular 
buffer (refer to figure 2-2-1). A circular buffer is a central memory storage area 
that contains data during input/output operations. It is called a circular buffer because 
routines that process input/output treat the first word of the buffer area as contiguous 
to the last word of the buffer area. 

All input/output is performed by passing data between a circular buffer (in central 
memory) and a peripheral device (mass storage or magnetic tape, for example). 
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circular buffer 



file environment table 


(FET) 


file name 


code and 
staus 


parameters 


FIRST 





IN 





OUT 


parameters 


LIMIT 


WMMMMM^, 




LIMIT 



not used 



Figure 2-2-1. Circular Buffer 



FIRST ADDRESS 

FIRST is the first word address of the buffer area. Routines that perform input /output 
never change the value of FIRST. 
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Figure 2-2-5. Standard FET for Labeled Magnetic Tape File (CIO) 



Refer to the LABEL and OPEN macros for a description of the FET fields used in processing 
ANSI labels. 



Parameter 



Local file name (Ifn) 



Word 
(FET+n) 



Level number (In) 



Abnormal termination 
Codes (at) 



Position Description 

59-18 The Ifn field contains one to seven alpha- 

numeric display code characters, left- 
justified; unused characters are zero- 
filled. The Ifn is the common reference 
point for all system communication 
concerning the file. 

17-14 This is the level number for an EOR/EOF 

operation on the file. NOS uses this field 
for CIO operations and for distinguishing 
interactive input from noninteractive input 
(refer to CIO in section 3 and the discus- 
sion on writing interactive programs, 
section 12). 

13-10 Status information returned by the func- 

tion processor when an abnormal situation 
or error occurs. This field is usually 
set by the processor when the error pro- 
cessing bit (ep) is set in FET+1. For 
some processors, at is returned in bits 
17 through 10. This field is set to 223 
by CIO if the ep bit is not set and an 
error condition is present. Function 
processor descriptions should be con- 
sulted for the specific error codes 
returned. § 
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Parameter 



Word 
(FET+n) 



Code 



Position Description 

9-0 Request/return code. The user (or 

macro) sets this code for the request 
desired. The function processors alter 
it only if the request is not completed. 
For example, the user requests a read 
(CIO code 010) but encounters an EOR. 
CIO returns a status code of 021. These 
codes are detailed in the function pro- 
cessor descriptions.. 

The following are subfields for the code 
parameter. 

Bit 1: file mode (fm). File mode for 
input /output operations on S, L, or SI 
tape formats only. For S or L format 
tapes, bit 1 is: 

Coded 

1 Binary 

Binary mode must be selected for SI 
tape formats or the job step is aborted. 



Device type (dt) 



59-48 



Random access (r) 



User processing (up) 



47 



45 



Bit 0: Interlock (ilk). FET interlock bit. 
Used to indicate system/user access to 
data associated with the file. The user 
sets this bit to (busy or not complete) 
and the processor sets it to 1 when 
completed. 

The 12-bit display code of the type of de- 
vice on which the file is or will be re- 
siding. If bit 59 is set, it indicates a 
nonallocatable device (refer to appendix 
E). If an S, L, or SI file is opened, this 
field contains NOS/BE compatible return 
information (refer to the OPEN macro). 

This bit is set if random processing is 
to be performed on the file. If this is 
set, the FET must be at least seven words 
in length. 

The user sets this bit if he desires to per- 
form his own end-of-reel or end-of- 
device processing. When CIO encounters 
an end-of-reel/end-of-device, it returns 
an abnormal termination code of 1 (bits 
13 through 10 of FET+0). For further 
information about end-of-reel processing, 
refer to the CIO CLOSER macro. The up 
bit is checked only if the FET is at least 
six words in length. 
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Parameter 



Error processing (ep) 



Word 
(FET+n) 



Position 



44 



Description 

This bit is used to indicate to the function 
processor that the calling program pro- 
cesses errors that occur, such as parity 
errors or errors in requests to the file 
managers. The function processor re- 
turns the error code in the at field of 
FET+0. Function processor descrip- 
tions should be consulted for the error 
codes returned. If this bit is not set, 
the function processor either aborts 
the job or requests operator intervention. 

If an unrecovered parity or block too 
large error occurs during a magnetic 
tape read operation (with the ep bit set) 
or if a read parity error occurs on a 
mass storage read operation (with ep bit 
set), the following steps occur. 



1. The data in the bad block is 
stored in the user's circular 
buffer. 

2. The value of the IN pointer prior 
to the read is stored in the next 
word in the circular buffer (pointer 
to the beginning of the bad data 
block). 

3. The parity error code is set in 
FET+0. 

4. The IN pointer is updated in the 
FET. This IN pointer value does 
not include the additional word 
(pointer to the beginning of the 
bad data block) stored in the 
buffer. 

5. The FET completion bit is set. 

The pointer to the bad data is returned 
on all reads processed by CIO for a mass 
storage file. If no data is transferred 
(correct PRU not read), the pointer points 
to itself, and no update of IN occurs. 

If tape error processing is inhibited 
(refer to the LABEL macro, section 4), 
the preceding steps are not performed 
regardless of whether or not the ep bit 
is set. 



Extended label pro- 
cessing (xl) 



41 



Specifies standard (xl = 0) or extended 
(xl = 1) tape label processing. 
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Parameter 



Flush bit (fb) 



Word 
(FET+n) 



Position 



36 



Description 

Specifies that the file's circular buffer 
is to be flushed upon abnormal termina- 
tion or for terminal files when the job is 
rolled out. 

Files that are pointed to by the list of 
files (refer to the SETLOF macro, sec- 
tion 6) and meet the following criteria 
are flushed with the appropriate write 
function. Files are flushed with an end- 
of-record write (CIO function 024) unless 
the last function in the FET is a WRITECW 
(204) or WRITEN (264), in which case 
that function is reissued. 



NOTE 



Care must be taken when select- 
ing random files to be flushed 
since they could be truncated by 
an end-of-record write. 



Original error flag (ef) is less 
than SPET (refer to EREXIT 
macro, section 6). 

No buffer parameter errors; 
that is: 

Complete FET within user's 
field length 

LIMIT .LE. FL 
OUT .LT. LIMIT 
OUT .GE. FIRST 

IN . LT. LIMIT 
IN .GE. FIRST 

Write bit is set in the FET or 
the FET is unused (bits 9 through 
3 are 0). 

No CIO error code exists in 
FET. 

Data is in buffer. 
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Parameter 



FET length ( f ) 



Word 
(FET+n) Position 



23-18 



FIRST 

IN 

OUT 

FNT pointer 



17-0 
17-0 

17-0 

59-48 



Physical record unit 
size 



35-18 



LIMIT 



First word address 
of working storage 



17-0 



47-30 



Description 

Specifies the additional length of the FET 
over normal size (five words). For 
example, if f = 3, FET length = 8 and 
FET+7 is the last usable word. Function 
processors require varying lengths for 
particular parameters. However, it is 
recommended that the FET for mass 
storage files be at least seven words for 
most efficient system processing. 

First word address of input/output buffer. 

The next available location for entering 
data into the buffer. The upper 42 bits 
should never be used since the function 
processors read and write the entire word. 

The next available location for removing 
data from the buffer. The upper 42 bits 
should never be used since the function 
processors read and write the entire word. 

Address of the file name table (FNT) 
entry for the file. This pointer is used 
by the system to reduce overhead when 
processing a file. It is set only if the 
FET length is greater than 5. 

Number of CM words in PRU of the de- 
vice to which the file is assigned. The 
PRU size for mass storage is always 64 
CM words. The PRU size for magnetic 
tape varies according to the data format 
selected. 

This is set only if the file is opened 
using the CIO OPEN macro and if the 
FET length is greater than 5. Refer to 
appendix J for information on magnetic 
tape PRU size. 

Last word address plus 1 of the buffer. 
Data is never placed in or removed from 
LIMIT. 

First word address of working storage. 
Working storage is used by several of 
the compilers to control input/output in 
specific formats (blocking/unblocking). 
This parameter is not used by the system 
or the NOS common decks which refer to 
working storage areas. Working storage 
areas for use by macros (READS, READC, 
and so forth) require the user to define 
his own working storage area and specify 
it on each macro request. Pointers to 
working storage can be placed here foi^ 
reference. 
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Parameter 



Working storage last 
word address + 1 

List address (la) 



Current random index 
(cri) 



(FET+n) 


Position 


5 


17-0 


5 


17-0 



59-30 



Random rewrite 
request (w) 



29 



Unused bit count 
(ubc) 

Random request 
(rr) 



29-24 



28-0 



Maximum logical 
record size 
(mlrs) 

Index length (il) 



17-0 



35-18 



Description 

Last word address plus 1 of working 
storage* 

List address. This points to the table 
of the relative sector addresses for CIO 
READLS and RPHRLS macros. 

The current random index for the mass 
storage file being randomly accessed. 
The system returns the current position 
of the file after a random input/output 
request. This is in the form of a relative 
sector address (rsa) from the beginning 
of the file. For any nonrandom read or 
write operation, the system updates this 
field by adding the number of sectors 
transferred to the existing contents of the 
field. For any random access or posi- 
tioning operation, the value is recalcu- 
lated, cri is ignored if r (FET+1) is not 
set. 

This bit is set to indicate a write-in- 
place operation. If not set, the write 
takes place at the current position with rr 
being the address for the return of rsa, 
where the write began. This is ignored 
if r (FET+1) is not set. 

Specifies the unused bit count for S and 
L format tapes (refer to appendix J). 

Relative sector address (rsa) for a ran- 
dom input/output request. An exception 
is if w = and it is a write request, then 
it is the address for the return of the 
starting rsa of the write (previous EOI). 
If the error processing bit (FET+1, bit 
44) is set and an error occurs, the 
system returns detailed error status in- 
formation in FET+6, bits 11 through 0. 
For further information, refer to the de- 
scription of CIO. rr is ignored if r 
(FET+1) is not set. 

Specifies the maximum physical record 
size for S and L format tapes. Refer to 
appendix J. 

Random index length. This must be set 
by the user when requesting CIO OPEN 
to load the random index of a file or CIO 
CLOSE to dump the random index of a 
file. If r (FET+1) is not set, il is ignored. 
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The following parameters can be used to modify fields in the P^ET. They can be specified 
in any order. 



NOTE 



SETFET does not verify that the modified 
words are within the FET length. 



P,- 



BUF = fwa, length 



DTY=dt 



ERA=erad 



ERP = erp 



Description 

Changes the first word address of the CIO circular buffer to 
fwa and the length of the buffer to length. Thus, FIRST, IN, 
and OUT are changed to fwa and LIMIT is changed to fwa + 
length. 

Changes the device type to dt. The dt option is the display 
code equivalent of the device type, right-justified with binary 
zero fill in a register or a central memory location as de- 
scribed in SETFET Parameter Processing. Refer to appen- 
dix E for legal equipment codes. 

Changes the error message return address to erad for PFM 
requests (refer to Error Processing in section 5). 

Sets the error processing, user processing, or real-time 
processing bit, or combinations of the error and user pro- 
cessing or error and real-time processing bits. The erp 
option can be a mnemonic as follows. 



erp Value Description 

U 4 Set user processing bit at FET + 1, bit 

45. 



E 



R 



Set error processing bit at FET+1, bit 

44. 

Set real-time processing bit for PFM 
requests at FET+1, bit 43 (refer to 
section 5). 



UE 
ER 



Set both user processing bit and error 
processing bit. 

Set both error processing bit and real- 
time processing bit. 



If an erp other than those listed is specified, it must be 
a register or central memory location containing the value 
of erp (refer to SETFET Parameter Processing). 
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p. Description 

LFN=lfn Changes the local file name in FET+0 to Ifn. t 

PFN=pfn Changes the permanent file name in FET+8 to pfn for PFM 

requests, t 

PKN=pn Changes the pack name in FET + 12 to pn for PFM requests, t 

PWD=pwd Changes the password in FET + 10 to pwd for PFM requests, t 

UCW=ucw Changes the user control word in FET+11 to ucw for PFM 

requests, t 

USN = un Changes the alternate user number in FET+9 to un for PFM 

requests, t 



SETFET PARAMETER PROCESSING 

For the DTY, ERP (when mnemonics are not used), LFN, PFN, PKN, PWD, UCW, and 
USN parameters, the following rules apply. 

• If an option is represented by a register, the register contains the value to be 
placed in the FET. For example: 

SETFET F,(LFN=X4) 

uses the contents of X4 as the new local file name. 

• If an option is represented by a constant, the constant specifies the address con- 
taining the value to be placed in the FET. For example: 

SETFET F, (LFN = LOFN) 

uses the contents of location LOFN as the new local file name. The file name can 
be specified in a literal as follows: 

SETFET F,(LFN ==6LOUTPUT) 

1 o If an option is a register that is preceded by the number sign (#), tt the regis- 

ter specifies the address containing the value to be placed in the FET. For 
example, 

I SETFET F, #B3 

uses B3 as the address containing the value to be placed in the FET. 



tThis option is left- justified with binary zero fill in an X register or central memory 
location as described in SETFET Parameter Processing. 
I ttThe CDC graphic equivalence sign ( = ). 
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o If an option is a register expression or constant preceded by the equivalence sign, 
it specifies the address containing the address of the value to be placed in the FET, 
For example: 

SETFET F, (LFN=//FADDR) 

uses the contents of FADDR as the address containing the value to be placed in 
the FET. 

For the BUF and ERA parameters, the following rules apply. 

• If an option is represented by a register, the register contains the value to be 
placed in the FET. For example: 

SETFET F, (ERA=A5) 

uses the contents of A5 as the new error message return address. 

• If an option is represented by a constant, the constant specifies the address value 
to be placed in the FET (not the address containing the value). For example: 

SETFET F, (ERA=ERRBUF) 

uses the address ERRBUF as the new error message return address. 



SETFET EXAMPLES 

Example 1: 

The SETFET macro can be used to take advantage of the way in which FORTRAN passes 
parameters to subroutines. Assume a FORTRAN program calls a COMPASS subroutine 
GETF to retrieve a permanent file. The call accepts three parameters to select the 
local file name, permanent file name, and file password: 

CALL GETFdfn, pfn, pwd) 

When FORTRAN processes the call, it builds a central memory table with one entry 
for each parameter. The entry contains the actual address of the parameter. Before 
control is passed to the subroutine, FORTRAN sets the Al register to the first word 
address of the table. Thus, XI contains the address of the first parameter. If the 
call to GETF is: 

CALL GETF(DA TAX, BASE1,PWD1) 

the Al register is the first word address of the table of addresses, XI contains the 
address of DATAl, location A 1 + 1 contains the address of the next parameter, and so 
on. This fact can be used by SETFET as follows: 

SETFET F, (LFN=#Xl),(PFN=#Al + l),(PWD=#Al+2) 



F FILEB BUF,301B, (FET = 16D) 

BUF BSS 301B 
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Example 2: 

Similarly, a COMPASS program could place the values in the FET as follows: 

SAl DATAl 

SB3 BASEl 

SETFET F,(LFN=X1),(PFN=#B3),(PWD=PWD1) 



DATAl DATA OLDATAl 

BASEl DATA OLBASEl 

PWDl DATA OLPWDl 

F FILEB BUF, 301B, (FET = 16D) 

BUF BSS 301B 
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INPUT/OUTPUT 



BBBSSssxmBissasaa 



ggasBoaaa 



This section describes the process of performing input/output from a COMPASS program. 

The combined input/output (CIO) part includes those macros needed for file creation, read 
and write functions, and file positioning. The data transfer part includes those macros that 
allow the user to transfer information between the circular buffer and a working buffer area. 

The user can perform l/O directly through FETs using CIO or with CYBER Record Manager 
facilities that are available to COMPASS users through COMPASS macro calls. A brief 
description of Record Manager features is provided later in this section. 



CIO - COMBINED INPUT/OUTPUT 

The CIO read/write requests are used to transfer data between a file and a CIO circular 
buffer. The read requests transfer input files from a system storage medium to a CIO 
circular buffer. The write requests transfer output from a CIO circular buffer to a system 
storage medium. Also included in this group of requests are those which open and close 
files, those which update records in an existing mass storage file, and those which control 
positioning of the file. 

The format of the call to CIO is: 



59 



40 35 



il 



17 



RA+I 



CIO 



addr 



r 
n 
addr 



Auto recall, if desired 
Count for skip operations 
Address of the FET 
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Word FET+0 contains the following information. 

59 
FET + 



17 13 



Ifn 


In 


at 


code 



Ifn 
In 



at 



code 



Local file name 

Level number (0<ln< ITg) for an EOR/EOF operation on the 
file: 

EOR operation 
l-16g Same as level 
173 EOF operation 

Abnormal termination code returned by CIO: 
Code Description 

01 End of information encountered. 

02 Device full/end of reel encountered. 
04 Parity error. 

21 End of multifile set. 

22 Fatal error. 
Request/return code: 

Bit Description 

8-2 Individual error code from a CIO function. Refer 

to the specific function for the bit settings and 
their meanings. 

1 Binary operation if set (applies only to SI, S, 
and L format tapes); coded operation if zero 
(applies only to S and L format tapes). 







I NOTE I 



Binary mode must be selected for SI 
tape format or the job will be aborted. 



Operation complete if set. 



The file mode (fm) bit (bit 1) of FET+0 is not actually part of the status response, although 
it is returned as such. The fm bit is used by tape drivers, in some cases, to determine 
parity (seven-track) or whether conversion is required between character sets (nine-track). 
For disk I/O, the bit is carried for compatibility with tape I/O but is meaningless. The bit 
is set by the FILEB or FILEC macros or directly by the user. After this it is masked in 
as part of the return code. 

The CPU program is expected to issue an even request code (bit = 0). If it does not, a 
completed operation may not be detected. 
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CIO uses FET+5 and FET+6 in the following manner. 



FET +5 


^^^^^m^^^^mm^^^mm^^ 


la 




Y/yy//////////////yy////////^ ubc T///// 


tnlrs 


+6 


cri wl rr/dec 1 



magnetic tape t 
mass storage 



la 

ubc 

mlrs 

cri 

w 

rr 



dec 



Address of a list of random addresses to be used with READLS 
or RPHRLS mass storage operations 

Unused bit count for S and L format tapes 

Maximum PRU size for S and L format tapes 

Current random index (for mass storage files only) 

Random rewrite request (for mass storage files only) 

Random request (for mass storage files only): if rr ^ 0, and 
the request is a read request, rr is the random index 

If rr / 0, w=0, and the request is a write request, rr is the 
address for return of random index (the write operation begins 
at the current EOI). The index of the EOI prior to the write 
is returned to the calling program. 

If rr i 0, w=l, and the request is a write request, rr is the 
random index indicating where the write will begin. 

Detail error return code (for mass storage files only). 



Code 



Type of Error 



xOOl 


Parity error 


x002 


Address error 


x003 


Device status error 



x004 6681 function reject or function sent to mass 

storage device that timed out with no 
response 

x005 Device reserved 

x006 Device not ready 

4007 Track limit (device full) 

If, after a read error (with ep bit set), the system, determines 
that the correct PRU was read (although it may contain incor- 
rect data) then x above is 0, the data is placed in the buffer, 
and the file is positioned to the next PRU of the file. If the 
correct PRU is not read, then x is 4, no data is placed in the 
buffer, and the file is not repositioned. The cri is set as 
usual. 



t These fields apply only to S and L format tapes. 
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Equipment which may be accessed by CIO includes: 

• Mass storage 

• Magnetic tape units 

CFO FUNCTION PROCESSING 

All of the CIO macros require two common decks for system interface. 

• COMCCIO 

• • COMCSYS 

These common decks are available to the user in relocatable form on the user library 
SYSLIB. 

If a CIO macro specifies a FET that currently does not have the completion bit set, 
the system will wait (by performing recalls) for completion before performing the 
specified function. 

Error processing for functions issued to CIO involves processing only those errors 
that occur on the specified devices which include read and write parity errors to m.ag- 
netic tape. If a mass storage device returns an error status or the device driver 
detects an error, the system places the error status in the FET+0 status field. If the 
error processing bit is set in the FET+1 ep field and the FET length is greater than 
five, a detail error code is returned to the user in the FET+6 dec field. 

ACCESSING FILES 

The two methods used to access files assigned to a job are sequential and random 
access. Any file can be accessed sequentially; however, only mass storage files can 
be accessed randomly. 

To read a file randomly, the system reads a portion of the file without reading all 
information in the file, from the current position to the desired position. Any mass 
storage file can be read randomly if the user knows which relative PRU (that is, which 
PRU in relation to the BOD he wishes to read. The desired PRU can be read by 
placing the PRU number in the FET and making the proper I/O requests. The random 
address of a PRU is the number of PRUs that precede the PRU on the file. The first 
PRU that can be read or written is PRU 1. PRU on all mass storage files is 
reserved for system use. 

Several methods of random processing exist. The specific method depends on the 
language being used; however, in all cases, the following points apply. 

o Most random I/O operations require a directory or index that contains the 
random disk addresses of records in the file. 

• An EOR or EOF I/O operation transfers one PRU for the EOR or EOF. 

• When randomly rewriting data within a file, the user must take care to ensure 
that data following the area he. wishes to write is not destroyed. 
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RANDOM REQUEST PROCESSING 

The user can request that the system perform the specified read or write request at the 
file position specified by the random request word (FET+6). If the file specified resides on 
mass storage and the random processing bit is set (r parameter in FET+1), then random 
access to the file can be performed. For a random write operation, the remainder of the 
file (the portion following the data written) is not released. On a sequential write operation, 
this portion of the file is released. 

The user is responsible for managing the random addresses. For any CIO operation with 
r set in FET+1, the system returns the current random index (cri) in FET+6. The cri is 
the position of the file when the operation is completed. 

Nonrandom write operations after an incomplete (no EOR or EOF written) random write 
operation are processed as random requests. Writing continues at the current position and 
the remainder of the file is not released. This feature makes the mid -record recalculation 
of the random address unnecessary when randomly writing records larger than the CIO 
circular buffer size. 

For a write operation with r set in FET+1, if rr = 0, a sequential write is performed at the 
current position. If rr/O, the action the system takes is as described for FET+6 fields 
earlier in this section. 

For a REWRITE operation with r set in FET+1, if rr=0, a random write is performed at 
the current position. If rr/0, a random write is performed at rr. 

For the random file shown in figure 2-3-2, the following random requests (that is, r is set 
in FET+1) are necessary to perform the operations described. 



Operation 


rr 


w 


cri 


Returned 


Description 


READ 


10 







11 


Read directory 


WRITER 


5 


1 




' \ 


Write new record 3 in place 


or 
REWRITER 


5 







3 I 


Word count = 138 


WRITER 


2000 







15 


Write new record at EOI; sy 



sets location 2000 to 12 to indi- 
cate where the write occurred 



WRITEF 


15 


1 


or 






REWRITEF 


15 






17 
17 



Rewrite directory 



The user must account for the extra sector written for EORs and EOFs when specifying 
rewrite -in -place operations. 
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The system computes the number of sectors written as follows: t 



Operation 


Formula 
n/100 


Word 
Count 

243 


Example 
243/100 


PRUs 
Written 

2 


Data Remaining 
in Buffer 


Buffer write 


43 


EOR write 


(n+100) 
100 


243 


(243+100) 
100 


3 









300 


(300+100) 
100 


4 





EOF write 


{n+200) 
100 


243 


(243+200) 
100 


4 









300 


(300+200) 


5 






100 



Appendix H contains examples of COMPASS programs that create, read, and write a 
random file. 

CIO OPEN AND CLOSE FUNCTIONS 

Two naacros are available for opening files. 

• OPEN is applicable to all files 

• POSMF is applicable only to labeled multifile tapes 

Two macros are available for closing files. 

• CLOSE is applicable to all files 

• CLOSER is applicable only to tape files 

POSMF is described in the discussion of file positioning functions. OPEN, CLOSE, and 
CLOSER are described in the following paragraphs. 

In general, there is no need to explicitly open or close mass storage files. The capabilities 
provided by open and close functions for mass storage files can be obtained through the use 
of other system macros. For example, appendix H illustrates the random processing of a 
file without using CIO open and close functions. Also, the example in this section of data 
transfer macros shows how a sequential mass storage file can be read and written without 
using open and close functions. 



•f- All numbers are in octal. 
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If the file resides on mass storage, the random processing bit is set, and the proper 
parameters are set in FET+7, CLOSE writes the data in the buffer specified in FET+7 at 
EOI of the file. This normally is the index for the file. A random index is written at the 
EOI only if the file is random; the file has been written on since the last OPEN request; 
the file is not locked; and an index area is specified in FET+7, bits 17 through 0. 



Example 1: 

Random processing for the program shown in example 1 of the OPEN macro can be 
terminated as follows: 



BUFL EQU 2001B 

INDXL EQU lOOB 

FILEl RFILEB BUF. BUFL, (FET=8), (IND=INDX, INDXL) 

BUF BSS BUFL 

INDX BSS INDXL 



OPEN 



FILEl.. R 



CLOSE 



FILEl.. R 



In this example, the system writes the random index contained in the index buffer at the end 
of the file. 

If the name of the file in FET+0 is PUNCH, PUNCHB, or P8, the file is entered in the 
punch queue. The file is punched in 026 or 02 9 mode, depending upon the origin of the job 
issuing the CLOSE request. If the job is not local batch origin, then the coded file is 
punched according to the system default keypunch mode (as specified by the installation). If 
the job is local batch origin, the initial keypunch mode of the job's control statement record 
(that is selected by the job statement or installation parameter) is the mode in which the 
deck is punched. 



NOTE 



CLOSE /UNLOAD and CLOSE /RETURN will not queue 
files in future versions of NOS. Programs using these 
functions should be rewritten to use the ROUTE macro 
if file queueing is desired. 

When a magnetic tape file is closed, the action the system takes depends on the last I/O 
operation performed. 
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The system responds to a CLOSE request on a magnetic tape file in the following 
manner. 

1. If the last operation was a write, the system performs one of the following 
functions. 

• If the tape is unlabeled and the data format is S, L, or F, the sys- 
tem writes four tape marks. 

• If the tape is unlabeled and the data format is I or SI, the system 
writes a tape mark, an EOFl label, and three tape marks. 

• If the tape is labeled and standard label processing is in effect (xl, 
bit 41 of FET+1, not set), the system writes a tape mark, an EOFl 
label, and three tape marks. 

• If the tape is labeled and extended label processing is in effect (xl, 

bit 41 of FET+1, set), the system writes a tape mark, an EOFl label, 
all user end-of-file labels (EOF2 through EOF9) and user trailer 
labels (UTL) present in the extended label buffer, and two tape marks. 
All nonappUcable labels, including EOFl and EOVl labels, in the ex- 
tended label buffer are ignored. Refer to Extended Label Processing 
earlier in this section for a description of the label buffer. 

If the last operation was a read and the following are true, then all labels 
from this tape mark (beginning with EOFl) through the next tape mark are 
transferred to the extended label buffer, as space permits, beginning at the 
first word of the buffer. 

• The tape is labeled 

• Extended label processing is in effect (xl, bit 41 of FET+1, set) 

• A tape mark immediately follows 

2. If the no rewind (NR) option was selected, the tape remains positioned at or 
is repositioned to the same point as before the CLOSE was issued (to prevent 
user from going past EOI). 

If the rewind (REWIND) option was selected, the system rewinds the tape to 
the beginning of data of the current file. This operation is performed auto- 
matically even if the current file begins on another reel. 

If the unload (UNLOAD) option was selected, the system rewinds and unloads 
the current tape reel, releasing job and file attachment. 



NOTE 



If PO=U processing option was specified at tape 
assignment time, the tape will not be physically 
unloaded from the tape drive. 

If the return (RETURN) option was selected, the system rewinds and unloads 
the current tape reel, releasing job and file attachment. The number of tapes 
scheduled for the job is decremented only if the total concurrent resource 
demand (tapes and packs)t has been satisfied. 



t Refer to the RESOURC control statement, section 6, volume 1. 
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Macro Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELOS 




RPHR 


addr, r 



addr 
r 



Address of the FET 

If r is specified, control is returned only upon completion 
of the operation 



READ (010) 

The READ function reads information into the circular buffer. If there is room in the buffer 
for at least one full physical record, the system initiates reading and continues until: 

• The available circular buffer space will not accommodate one full PRU. 

• An end-of- record or end-of-file is encountered. 

• The end-of- information is encountered. 

• For S and L format tapes, one PRU is read. 

The status responses (bits 17 through of FET+0) are: 

000011 Buffer filled 

000021 EOR encountered 

740031 EOF encountered 

741031 EOl encountered 

Data is not transferred after an EOR or EOF mark is encountered. For tapes that do not 
have a defined EOI (refer to appendix J), an operation that normally would terminate at 
EOI terminates instead at EOF. Also, for S and L format tapes, the unused bit count is 
returned to FET+6, bits 2 9 through 24, when the read is complete. 

Macro Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELOS 




READ 


addr, r 



addr 
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Address of the FET 

If r is specified, control is not returned until operation is 
complete 
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READSKP (020) 

READSKP performs a read function until the buffer is filled or until an EOR or EOF is 
= encountered. If the buffer is filled before an EOR is encountered, CIO positions the file 
at the next EOR, EOF, or EOI, whichever is encountered first. 

The status responses (bits 17 through of FET+0) are: 

000021 Buffer filled or EOR encountered 

740031 EOF encountered 

741031 EOI encountered 

For tapes that do not have a defined EOI (refer to appendix J), an operation that normally 
terminates at EOI terminates instead at EOF. 

.This is the only read function that perforins the read operation if less than one PRU 
of space is available in the buffer. 

Macro Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELOS 




READSKP 


addr,level, r 



addr 
level 



Address of the FET 

Level number (0 through 17o) specified in FET+0, bits 
17 through 14; if a level number is specified, information 
is skipped urftil the occurrence of an EOR with a level 
number greater than or equal to the one specified: 

After the buffer is full, skip to the next EOR 

17-. After the buffer is full or a full record is placed 

in the buffer, skip to the next EOF 



For S and L format tapes, only a request with level 17o is 
recognized; any other level in the request is ignored 

r If r is specified, control is returned only upon completion 

of the operation 

For S and L format tapes, the user should set the mlrs field (FET+6, bits 17 through 0) 
before issuing the READSKP function. If mlrs is 0, the system assumes 512 words for an 
S tape and 377777 octal for an L tape. Thus, if a READSKP is issued on an L tape and 
mlrs is 0, a block too large error occurs if a block is encountered that is greater than 
377777 octal CM words. 



READCW (200) 

The READCW function performs a nonstop read of PRUs bounded by control words, 
PRU format is: 



The 
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Macro Format: 



lOCATION 



OPERATION 



READN 



VARIABLE SUBFIEIDS 



addr, r 



addr 



Address of the FET 



r If r is specified, control is returned only upon completion 

of the operation 

Before this function is issued, the mlrs field in FET+6, bits 17 through 0, must be set 
to the largest physical record that will be encountered. For S format, if mlrs = 0, the 
value of the maximum block is assumed to be 512 words. For L format, if mlrs=0, 
the assumed maximum block is LIMIT-FIRST- 2. In addition, the file mode (FET+0, 
bit 1) must be set. 

Each physical record in the circular buffer is preceded by a header word. This word 
is generated by the system; it does not exist on the tape. The format of the header 
word is: 



59 




29 


23 




7 







w//////m 


W//////M 


ubc 


^ 


^ 


block size 



ubc 



Unused bit count. Number of bits in the last word that are 
not valid data; ubc may range from to 55. 



block size Number of CM words in the physical record 

After each complete physical record has been placed in the buffer, the system moves 
the IN pointer to reflect both the header and the data. 

READEI (600) 

The READEI function reads information into the circular buffer. Reading continues until 
an EOI mark is encountered or the buffer is filled. The status response is EOI encountered 
(741031). The file is positioned at EOI. 

IVlacro Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




READEI 


addr, r 



addr 
r 



Address of the FET 

If r is specified, control is returned only upon completion 
of the operation 
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CIO WRITE FUNCTIONS 

The following write functions are processed by CIO. 

WPHR (004) 

WPHR writes one physical record from the circular buffer. Unless the buffer contains 
at least one PRU, no operation occurs. 

Macro Format: 



LOCATION 


OPERATION 


VARIABLE SU8FIELDS 




WPHR 


addr, r 



addr 
r 



Address of the FET 

If r is specified, control is not returned until the operation 
is complete 



WRITE (014) 

WRITE transfers the contents of the circular buffer to the specified file. Writing continues 
until the buffer contains less than one PRU of data (a WRITER request empties the buffer 
and writes an end-of-record on the file). 

Macro Format: 



LOCATION 



OPERATION 



WRITE 



VARIABLE SUBFIELDS 



addr, r 



addr 
r 



Address of the FET 
Auto recall option: 



other 



The - option sets the WRITE function code (CIO 
function code OI43) in FET+0 and returns to the 
calling program. No actual WRITE function is 
performed at this time. 

For further information concerning use of the ''- 
option, refer to WRITECW (204) later in this 
section. 

Control is not returned until the operation is 
complete 



For S and L format tapes, only one record is written for each request. The length of the 
record is determined by the value of the IN and OUT pointers. 
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WRITER (024) 

WRITER writes the entire contents of the buffer to the file specified. | The last PRU is 
written as a short PRU (refer to appendix J). If the data exactly fills the last PRU, the 
system adds a PRU with no data to indicate the end of the record. A WRITER request 
with level 17o set in FET+0, bits 17 through 14, performs the same operation as a WRITEF 
request. 

Macro Format: 



LOCATION 


OPERATiON 


VARIABLE SUBFIEIDS 




WRITER 


addr, r 



addr 



Address of the FET 



If r is specified, control is not returned until the operation 
is complete 



WRITEF (034) 



WRITEF writes the entire contents of the buffer to the file specified. -f- The last PRU 
written is the end-of-file. If data does not exactly fill the last PRU, the system writes a 
short PRU (refer to appendix J) and an EOF. If the buffer is empty and the last operation 
was an incomplete write (last PRU written was not EOR or EOF), an EOR (PRU with no 
data) and an EOF are written; otherwise only an EOF is written. For S and L format tapes, 
data in the buffer is transferred to tape and followed by a tape mark. 

Macro Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




WRITEF 


addr, r 



addr 
r 



Address of the FET 

If r is specified, control is not returned until the operation 
is complete 



tThe OUT pointer is updated. The IN pointer is not changed. 
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WRITECW (204) 

The WRITECW function performs a nonstop write of PRUs bounded by control words. 
The PRUs are in the same format as specified for READCW. Data written using this 
function is stored on the device in the same format as if it had been written with any 
other write function (that is, the control words are not part of the data). 

WRITECW may only be used with mass storage and magnetic tape devices. 



Macro F.ormat: 



lOCATlON 


OPERATION 


VARIABLE SUBFIEIDS 




WRITECW 


addr, r 



addr 
r 



Address of the FET 



Auto recall option: 



The - option sets the WRITECW function code (CIO 
function code 204g) in FET+0 and returns to the 
calling program. No actual WRITECW function 
is performed at this time. 

If the symbol WRIF$ is defined in assembly and a 
data transfer common deck attempts to issue a 
write request (refer to Data Transfer Macros in 
this section), it will use the CIO request set in the 
FET instead of a WRITE (014g) request. The data 
transfer common decks, by default, issue a WRITE 
(0143) request if WRIF$ is not defined. The 
WRITE macro can be used to reset the FET after 
using the - option with a WRITECW, WRITEN, or 
REWRITE macro. 

If used, this option should be issued before any 
writing is performed on the file. 



NOTE 



The appropriate data transfer common 
deck must be assembled within the user's 
program (that is, the SYSLIB version 
cannot be used) or the WRIF$ is mean- 
ingless. 
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For example, the following sequence assures that 
the data transfer common deck COMCWTW issues 
a WRITECW request instead of a WRITE request 
if it is required to write the circular buffer. 



IDENT 



WRT 



WRIF$ EQU 

OPL XT EXT COMCWTW 



WRITECW F, - 



WRITEW F,WBUF, lOOB 



F FILEB FBUF,2001B, FET = 13 

FBUF BSS 2001B 

WBUF BSS lOOB 



END 



WRT 



other Control is not returned until the operation is 
complete. 



REWRITE (214) 

REWRITE performs the same operation as the WRITE function with the exception that 
it causes the system to process the operation as a random function; that is, that por- 
tion of the file following the portion written is not destroyed. If the random parameters 
(r, rr, and w) are not specified in the FET, the write operation takes place at the 
current position. If the random parameters rr and w are specified, the normal random 
addressing procedures are followed. The file to be rewritten must reside on mass 
storage. A subsequent CLOSE function will not cause an update of the random index 
for the file, unless another CIO write function other than REWRITE, REWRITER, or 
REWRITEF has been performed since the last OPEN function. 



NOTE 



REWRITE does not check if the record being 
rewritten in place is the same size or less 
than the original record. 
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Macro Format; 



lOCATION 


OPERATION 


VARIABLE SUBFIEIOS 




REWRITE 


addr, r 



addr 
r 



Address of the FET 



Auto recall option 



other 



The - option sets the REWRITE function code (CIO 
function code 214g) in FET+0 and returns to the 
calling program. No actual REWRITE function 
is performed at this time. 

For further information concerning use of the 
* option, refer to the WRITECW macro. 

Control is not returned until the operation is 
complete. 



REWRITER (224) 

RE WRITER performs the same task as WRITER with the exceptions noted for REWRITE. 
The file must reside on mass storage. If the level number is 17g, REWRITER per- 
forms the same operation as REWRITEF. 

Macro Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




REWRITER 


addr, r 



addr 
r 



Address of the FET 

If r is specified, control is not returned until the operation 
is complete 



NOTE 



A short PRU is written even if the last PRU is 
exactly full. 
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REWRITEF (234) 

REWRITEF performs the same task as WRITEF with the exceptions noted for REWRITE. 
The file specified must reside on mass storage. A subsequent CLOSE function will 
not cause an update of the random index for the file, unless another CIO write function 
other than REWRITE, REWRITER, or REWRITEF has been performed since the last 
OPEN function. 



Macro Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




REWRITEF 


addr, r 



addr 
r 



Address of the FET 

If r is specified, control is not returned until the operation 
is complete 



NOTE 



An extra PRU is written to specify an EOF, 



WRITEN (264) 



The WRITEN macro writes nonstop on an S or L formatted magnetic tape. S and L 
formatted tapes are described in appendix J. Writing continues until the buffer is empty 
or end-of-reel is encountered. 

Macro Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




WRITEN 


addr, r 



addr 



Address of the FET 



60445300 M 



2-3-35 



r Auto recall option: 

- The - option sets the WRITEN function code (CIO 

function code 264g) in FET+0 and returns to the 
calling program. No actual WRITEN function is 
performed at this time. 

For further information concerning use of the 
- option, refer to the WRITECW macro. 

other Control is not returned until the operation is 
complete. 

The user must pro\i.de a header word immediately preceding each record in the buffer. 
This header is not physically written on the tape. Its format is: 



59 29 23 17 



ubc 



block size 



ubc Unused bit count. Number of bits that are not valid data 

in the last word; ubc may range from to 55. 

block size Number of CM words in the physical record. 

The system compares the mlrs and ubc fields in FET+6 using information from this 
header. 

The OUT pointer is not changed to reflect the move until after each complete record 
has been written to tape. 

FILE POSITIONING FUNCTIONS 

The following functions control the positioning of a file. If the FET indicates that the file 

is being accessed randomly, the random address of the new position (cri) is always returned. 

Status responses assume coded mode (bit 1 of FET+0 clear). If binary mode is specified 
(bit 1 of FET+0 set), the responses end in 3 instead of 1. That is, 041 for coded mode be- 
comes 043 for binary mode. 

BKSP (040) 

BKSP causes a file to be backspaced one logical record. If BOI or the load point of a tape 
file is encountered before backspacing is complete, a rewind status is returned (05x). If 
the backspace causes the file to be positioned exactly at BOI, a backspace status is returned 
(041). 

If the operation terminates on an EOF, 17o is returned to the FET level number (In) field 
(FET+0, bits 17 through 14). 
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• If located at the end of fLle set member 2 (F), a rewind positions the tape to 
the beginning of Volume I since file set member 2 begins on Volume I, and 
then positions Volume I to D. 

• By writing over file set member 2, file set member 3 is destroyed. 

• A POSMF 999 followed by a WRITE creates a file set member at I. 

e To copy all three file set members, the following technique may be used. 

OPEN with display code 001 (or 0001) sequence number and all other label 
fields binary zero. 

READ to EOI. (C) 

POSMF with display code 002 (or 0002) sequence number and all other label 
fields binary zero. This positions to next file set member at (D). 

READ to EOI. (F) 

POSMF with display code 003 (or 0003) sequence number and all other label 
fields binary zero. 

READ to EOI. (H) 

The SI (M) parameter must be present for multifile label positioning using control 
statem.ents. If the QN (P) parameter is present, the multifile set is positioned to the 
file set member that matches the specified sequence number. If QN is not specified 
and the FI (L) parameter is present, the multifile set is positioned to the file set 
member that matches the file identifier specified. If both QN and FI are specified, 
a match must occur on both sequence num.ber and file identifier. If neither QN nor FI 
is specified, an OPEN is done instead of a POSMF. 

To extend a multifile set, QN must be set to 9999. t 

Setting the QN parameter to zero advances the pointer to the next multifile. This is 
not true from a LABEL control statement. 

If the SI parameter is not specified, then file positioning is not done. The R and W 
parameters on the LABEL statement are ignored if SI is specified. The exception is 
if the W parameter is specified and QN< 1, and it is the first OPEN on the file, then 
an OPEN/ WRITE is performed. 



tWhen a multifile set is extended, the set ID of the new file is always set to the same value 
as the previous file. This ensures that the set ID of all set members are the same. 
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Although the sequence number field in the HDRl label is four characters in length, only 
the rightmost" three characters are used to differentiate between 999 and another valid 
sequence number. This occurs because on an open (POSMF), the FET field for sequence 
is only three characters. Therefore, if extended labels are not being used, a limit of 998 
file set members per file set is enforced. 

EVICT (114) 

The EVICT macro is similar to the RETURN macro in that it releases file space for 
the specified file. It differs from RETURN in that EVICT does not release the file 
attachment to the job. When an EVICT is performed on a deferred routed queue file 
(refer to ROUTE macro, section 8), all file routing information associated with the file 
is cleared. 

Macro Format: 



lOCATION 


OPERATION 


VARIABLE SUBFIELDS 




EVICT 


addr, r 



addr Address of the FET 

r If r is specified, control is not returned until the operation 

is complete 

The operation that EVICT performs depends on the file type. For the primary file and 
permanent files, all file space except the first track is released, job attachment remains, 
and an EOI is written on the first sector of the first track. For all other mass storage 
file types, file space is released and job attachment remains. Files for which write lock- 
out is set are returned to the system. An EVICT of a tape file performs the same functions 
as the UNLOAD macro. 

SKIPF (240) 

SKIPF causes the file to be positioned n records forward from the current position. 
The operation terminates when the skip count is satisfied or when EOI is encountered 
on a mass storage file or a tape file. 



The status responses (bits 17 through of FET+0) are: 
0261 Last record skipped was EOR 

740271 Last record skipped was EOF 

741271 EOI encountered 
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IDENT COPYFIL 
ENTRY COPYFIL 
SYSCOM B1 



** ASSEMBLY CONSTANTS. 

IBUFL EQU 1001B 

OBUFL EQU 2001B 

WBUFL EQU lOOB 



INPUT BUFFER LENGTH 
OUTPUT BUFFER LENGTH 
WORKING BUFFER LENGTH 



** 



FETS. 



I 

INP 

OUT 



«« 



BSS 

FILEB IBUF, IBUFL 

BSS 

FILEB OBUF, OBUFL 

MAIN PROGRAM. 



COPYFIL 



SB1 1 
REWIND 
REWIND I 



C0P1 



READ I 
RECALL 



INITIATE READ OF LOGICAL RECORD 



C0P2 READW I,WBUF,WBUFL 

ZR X1,C0P3 IF NOT EOR/EOF 

NG X1,C0P4 IF EOF OR EOI ENCOUNTERED 

EOR ENCOUNTERED. COPY DATA IN WBUF TO OUTPUT FILE. 

WRITEW 0, WBUF, XI -WBUF WRITE LAST PORTION OF RECORD 

WRITER WRITE END-OF-RECORD 

EQ C0P1 INITIATE READ OF NEXT RECORD 



COP 3 


WRITEW 


0,WBUF, 




EQ 


C0P2 


COP 4 


SX1 


X1+1 




NG 


X1,C0P5 




WRITEF 







EQ 


COPl 


C0P5 


ENDRUN 




* 


BUFFERS. 


IBUF 


BSS 


IBUFL 


OBUF 


BSS 


OBUFL 


WBUF 


BSS 


WBUFL 



TRANSFER MORE DATA TO WBUF 



IF EOI ENCOUNTERED 

WRITE END-OF-FILE 

INITIATE READ OF NEXT RECORD 



INPUT BUFFER 
OUTPUT BUFFER 
WORKING BUFFER 



END 



COPYFIL 
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In the previous example, if the RECALL function was not specified for the output file, 
the following steps could occur. 

1. The user program issues the REWIND O function, 

2. Since auto recall is not specified, the user program continues execution, 

3. At some point, the user program issues WRITEW which moves data from 
WBUF to the input/output buffer (O) starting at the current IN pointer in the 
FET. The WRITEW macro advances the IN pointer to reflect the amount of 
data transferred into the buffer. 

4. At this point, the system completes the REWIND function and accordingly 
updates the FET IN and OUT pointers to point to FIRST (empty buffer). This 
destroys the IN pointer updated in step 3. The data placed in the buffer is 
ignored. 

5. On subsequent EOR operations (WRITER), the same situation could occur if the 
RECALL function was placed elsewhere. 

WRITER O 

must place RECALL O here. 
WRITEW O.WBUF,WBUFL 



Write requests in the previous example are not issued with auto recall specified be- 
cause other operations (READ, for example) can be performed before it is necessary 
to have the write operation completed. 

In the previous example, if an EOR or EOF mark is not detected, it is not necessary to 
reissue READ requests to fill the input/output buffer because the data transfer macros and 
associated common decks detect when the buffer threshold is reached. If this threshold is 
reached, a request is issued to CIO by the common deck. This occurs with the READW 
macro when the empty space in the buffer exceeds the threshold or with the WRITEW macro 
when data in the buffer exceeds the threshold. The threshold used is half the buffer size. 
That is, if the buffer is less than half full, a read request is issued; if it is more than half 
full, a write request is issued. This threshold applies only when the buffer is 512 (lOOOj.) 
words or more in length. When the buffer is smaller, the read or write function is re- 
issued only when the buffer is empty for a read or full for a write. 

Assuming no EOR or EOF is encountered by the fifth time through the loop, IBUF is less 
than half full since 2 56 (400o) words were read. The READW function then issues another 
CIO request to transfer data from file I to circular buffer IBUF. On the ninth time through 
the loop, the WRITEW function issues a WRITE request to file O since OBUF is now more 
than half full. 

For the data transfer macros, the common decks required for absolute assemblies, in 
addition to those specified with each macro, are: 

• COMCCIO 

• COMCSYS 

• COMCWTW for write functions (except WRITEO) 

• COMCRDW for read functions (except READO) 
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LOCAL FILE MANAGER 



iBcanBBsnEi 



Local file manager (LFM) performs requests associated with the control of a user's files. 
The format of the call to LFM is: 



59 



40 35 



23 17 



VTTy 



RA+I 



LFM 



code 



fp 



addr 



r Auto recall bit (must be set) 

code Function code 

fp Function parameter 

addr Address of the FET 



LFM uses the following information from the FET. 





59 


47 


44 


7 





FET + 


Ifn 


W/////////A. 


c 


+ 1 


dt 


% 


e 
P 


mm^^^^^mmm^^mm^ 



Ifn 
c 
dt 
ep 



Local file name 
Completion bit 
Device type 
Error processing bit 



After the request is completed, the first word of 'the FET contains the following 
information. 



59 



17 



FET+0 



Ifn 


at 


WM 


c 



at 
c 



Abnormal termination code 
Completion bit 



The common decks required in absolute assemblies for the macros processed by LFM 
are: 



o COMCLFM 
• COMCSYS 



For relocatable assemblies, these decks are satisfied by default from the library SYSLIB. 
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ERROR PROCESSING 

The user can issue requests to LFM and have control returned if certain error conditions 
occur. To do this, the error processor bit (ep) must be specified in FET+1. The following 
error codes are returned in the abnormal termination (at) code field of FET+0, bits 17 
through 10. 



Error Codes 


Description 


Error Codes 


Description 


1 


File not found 


16 


I/O sequence error 


2 


File name error 


17 


Output file limit 


3 


Illegal file type 


20 


Local file limit 


4 


File em.pty 


21 


No mass storage avail-^ 


5 


MAGNET not active 




able 


6 


Duplicate common file name 


22 


Illegal file mode 






23 


FET too short 


7 


Illegal equipment 










24 


GETFNT table too large 


10 


Equipment not available 




11 


Duplicate file name 


25 


Illegal change in file/ 
origin type 


12 


Illegal user access 


26 


Parameter block busy 


13 


Illegal user number 








27 


Address out of range 


14 


Illegal ID code 








30 


System error 


15 


Resource executive (RE- 


31 


Illegal random address 



The following error causes the job step to be aborted regardless of the presence of the user 
error processing bit in the FET. 

LFM ILLEGAL REQUEST. 

This message is issued if any of the following situations occur. 

• An LFM function is issued without the auto recall bit set. All LFM calls must be 
specified with recall. 

• An LFM function detected is not recognized as a legal function. 



RENAME (000) 

The RENAME function enables the user to change the name of a file currently assigned to the 
job to the name specified in FET+6. This does not change the names of files in the perma- 
nent file system. 

If a file by the new file name already exists, it is returned to the system. However, there 
are certain conditions under which the file tj^e of the old file is changed to that of the re- 
turned file. 

• If the old file is a local mass storage file and the returned file is a print, punch, 
or primary type file, the file type of the old file is changed to that of the returned 
file. 
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• If the old file is a local mass storage file and the returned file is not a print, punch, 
or primary type file, the old file is renamed but its file type is not changed. 

If the old file is not a local file or does not reside on mass storage, an 

ILLEGAL FILE TYPE. 

error message is issued. 

If the old file is a tape file and the calling program has a DMP= entry point (refer to appen- 
dix F), the following message is issued. 

SYSTEM ERROR. 

If the FET is not at least seven words in length, the following message is issued. 

FET TOO SHORT. 

Macro Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




RENAME 


addr, nfn 



addr Address of the FET (FET+O contains the old file name) 

nfn Address of new file name: 

If nfn = XI, XI contains the new file name. 

If nfn is not specified, FET+6 contains the new 
file name. 

ASSIGN (001) 

The ASSIGN function enables the user to access a library file. If a file by the re- 
quested name is already local to the user's job, no action is taken. If the requested 
library file is not found, the following message is issued. 

FILE NOT FOUND. 

If the error processing bit is set, the message is not issued and error code 1 is re- 
turned. 

The user must be validated to access library files or the following message is issued. 
ILLEGAL USER ACCESS. 

Macro Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELOS 




ASSIGN 


addr 



addr 



Address of the FET 
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COMMON (002) 



NOTE 



This macro will not be supported in future 
releases of NOS. The user should use per- 
manent files instead of library files. Refer 
to section 5 for a description of permanent 
file macros. 

The COMMON macro changes the file type of the specified file to library. The file 
must be a locked local file residing on a mass storage device. If it is not, the 
following message is issued. 

ILLEGAL FILE TYPE. 

If the file to be made library is in execute-only mode (refer to Permission Modes, 
File Categories in section 5), the following message is issued. 

ILLEGAL FILE MODE. 

If a file of the same name already exists as a library file, the following message is 
issued. 

DUPLICATE COMMON FILE NAME. 

If a file by the requested name is not found, the following message is issued, 
FILE NOT FOUND. 

If the equipment the file is assigned to is not mass storage, the following message is 
issued. 

ILLEGAL EQUIPMENT. 

The user must be validated to access library files or the following message is issued. 
ILLEGAL USER ACCESS. 

The file is no longer assigned to the user's job if the operation is successful. 
Macro Format: f 



lOCATION 



OPERATION 



COMMON 



VARIABLE SUBFIELOS 



addr 



addr Address of the FET of the file to be entered as a library 

file 



' This macro is not available in SYSTEXT. The user must specify systems text PSSTEXT 
or call common deck COMCCMD (refer to appendix A). 
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RELEASE (004, 005, 006, 007, 016, 030) 



NOTE I 



This macro will not be available in future releases 
of NOS. The user should use instead the ROUTE 
macro described in section 8. 

This function enables the user to release files to any of the output queues for processing 
before job termination. 

Any of the following file types can be released. 

• Local files 

• Print files 

• Punch files 

If any other type is released or the file is not a mass storage file, the following message 
is issued. 

ILLEGAL FILE TYPE. 

If the file is unused, the following message is issued. 

FILE EMPTY. 

If an attempt is made to change the file type or origin type of a deferred routed file 
(refer to section 8), the following message is issued. 

ILLEGAL CHANGE IN FILE/ORIGIN TYPE. 

In this case, the file must have its routing rescinded (DC^SC) before it can be released I 
to the desired file and origin type using the RELEASE macro. | 

If the number of files released to the output queue by the job has exceeded the limit for 
which the user is validated, the following message is issued and the job step is aborted. 

OUTPUT FILE LIMIT. 

If the file is an execute only file, the following message is issued. 

ILLEGAL FILE MODE. 

Macro Format: 



lOCATION 



OPERATION 



VARIABLE SUBFIEIOS 



RELEASE 



addr, type,ot,un 
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addr 


Address of the F 


ET 


type 


One of the follow 


ing: 




PRINT 


Release file to 
(function 004) 




PUNCH 


Release file to 
(function 005) 




PUNCH9 


Release file to 
(function 030) 




PUNCHB 


Release file to 
(function 006) 



ot 



un 



P8 



Release file to 



the PRINT queue 

the PUNCH 026 queue 

PUNCH 029 queue 

the PUNCHB queue 

the P8 queue (function 007) 

the local batch queue 
the remote batch queue 



Specifies disposition of output: 

EC Release file to 

(function 016) 

EI Release file to 

(function 016) 

Address containing the user number of the remote batch 
user to which the file is to be disposed (ignored if ot is BC). 
This parameter is valid only if the user is allowed deferred 
batch jobs. Also, un must match the user number of the 
user performing the RELEASE on all character positions 
except those containing an asterisk (-). 



If the ot and un parameters are not specified, a remote batch job disposes the file to 
a remote batch terminal from which the job is submitted and all other origin types 
dispose the file to the central site output device. If ot is BC, the un parameter is 
ignored and the file is disposed as usual to the central site device. 

The user may release coded punch files in either 026 or 029 mode, independent of 
the job's initial keypunch mode (refer to appendix F, volume 1). 

LOCK (010) 

This function enables the user to prevent writing on a file by setting the write lockout bit for 
the file. The file specified must be a local or primary file type; if it is not, the following 
message is issued. 

ILLEGAL FILE TYPE. 
Macro Format: 



lOCATION 


OPERATION 


VARIABLE SUBFIEIDS 




LOCK 


addr 



addr 



Address of the FET 
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Macro Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIEIDS 




STATUS 


addr, P 



addr Address of the FET 

P If P is specified, the current position is returned. If this 

parameter is omitted, LFM function 12 is executed. 



REQUEST (014) 

The REQUEST function requests operator assignment of equipment to a file. If the file 
is already assigned, the function is ignored. If dt in FET+1 is nonzero, the device assigned 
is of that type. If dt equals MS, a mass storage device must be assigned. The REQUEST 
function cannot be used to assign tape equipment. If dt is MT or NT, the job step is 
aborted and the following message is issued. 

ILLEGAL EQUIPMENT. 

If dt is zero, operator assignment of tape equipment is rejected and operator request 
for equipment continues until an acceptable device is assigned. The LABEL macro 
should be used for tape requests. 
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No special validation is required to assign allocatable devices such as mass storage 
or null equipment. All other equipment requires the user to be validated to use 
nonallocatable devices*}- or the following message is issued. 

ILLEGAL USER ACCESS. 

Macro Format: 



lOCATION 


OPERATION 


VARIABLE SUBFIELDS 




REQUEST 


addr, ,n 



addr Address of the FET 

li If this parameter is specified (any value may be used), the 

dayfile message indicating the equipment to which the file 
was assigned will not be issued. 

If REQUEST is to be used for checkpoint dumps, FET+7 specifies the checkpoint mode. 



59 



53 



FET + 7 



cm 



Checkpointtt mode indicates that addr is to be used as a 
checkpoint file: 

75g Each time a checkpoint dump is taken, 

the new information is written at the BOI 
of addr. 



76 



8 



Each time a checkpoint dump is taken, 
the new information is written at the 
previous EOI of addr. 



+ Refer to the LIMITS control statement, section 6, volume 1. 
•j-}- For further information, refer to the description of the CHECKPT macro, section 10. 
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The user can alternately write dumps on two checkpoint files by issuing two REQUESTS with 
cm = 753. If cm = 768 for alternate files or if more than two checkpoint files are specified, 
the job step is aborted and the following message is issued to the user's dayfile. 

CHECKPOINT FILE ERROR. 

REQUEST (015) 

This function assigns a file to an equipment according to the contents of the device type field 
in FET+1, If the file already exists, LFM issues the message 

DUPLICATE FILE NAME, 
to the dayfile and, unless user error processing is selected, aborts the job step. 
The device type (dt) field affects the file's assignment as follows: 

If dt is LFM assigns file to 

TT The terminal (interactive jobs only) 

MS Any allocatable mass storage device 

NE or 77o Null equipment 

If dt is LFM assigns file to device of preferred residence for 



TP 


Temporary files 


IN 


Input files 


OT 


Output files 


PY 


Primary files 


LO 


Local files 


LG 


Binary (executable) files 



The device of preferred residence for each of these file categories is determined by the site 
and is not subject to user control. 

System origin jobs or users with system origin privileges can specify equipment mnemonics 
other than those listed here, or can specify an EST ordinal, subject to the following restric- 
tion: the dt field must not specify a tape equipment, either by mnemonic or EST ordinal. 
LFM issues the message 

ILLEGAL EQUIPMENT. 

to the dayfile and aborts the job step if this restriction is violated. The LABEL macro 
(described in this section) should be used for tape requests. 

System origin jobs and users with system origin privileges may use function 015 for check- 
point dumps, thereby avoiding operator intervention. FET+7 should be formatted as 
described for function 014. 
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Macro Format: 



lOCATION 



addr 
u 



OPERATION 



REQUEST 



VARIABLE SUBFIEIDS 



addr, u, n 



Address of the FET 

If this parameter is specified (any value may be used), the 
device type in FET+1 is the device to which the file is assigned. 
If the device type in FET+1 is numeric, this is the EST ordinal 
to which the file is assigned. Absence of this parameter causes 
LFM function 014 to be issued. 

If this parameter is specified (any value may be used), the day- 
file message indicating the equipment to which the file was 
assigned will not be issued. 



SETID (017) 



NOTE I 



This macro will not be available in future releases 
of NOS. The user should use instead the ROUTE 
macro described in section 8. 

This function sets the identifier code for a file. This enables the user to direct ?n 
output file to a particular device. The output queue processors assign files to devices 
only if the ID codes are the same. If the file does not exist, it is created by this 
function. The file must be: input (INFT), print (PRFT), local (LOFT) or punch (PHFT), 
or the following message is issued. 

ILLEGAL FILE TYPE. 
Macro Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




SETID 


addr, n 



addr Address of the FET 

n Identifier code; 0<n<67 



8 
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ASSIGN (020) 

This function is used to access a library file. If tiie file is accessed from a system or 
library file, the return status code equals 0. 

The random address of the directory is stored in FET+6. 

The address bias for the directory is stored in FET+7. 

This function enables the user to access user libraries that exist either on files attached 
to the job or the system. The local files are searched first. Because of the structure 
of the system file, the address bias for the directory must be specified. For example, 
if the directory for SYSLIB is specified at random address 2000 (FET+6) on the system 
file, the bias for all entries in this directory , is 1777 (FET+7). This is the address 
to be added to the random addresses of all routines in this directory to access the 
routines from the system library. 

Jf the file specified is a system procedure file, the sign bit in FET+7 is set. If the 
file specified is not a system file, FET+6 and FET+7 are returned as zero. If the 
file specified is a relocatable file, FET+6 and FET+7 are unchanged. 

Macro Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELOS 




ASSIGN 


addr, L 



addr 
L 



Address of the FET 

If L is specified, the file is assigned from the system file. 
The absence of this parameter causes LFM function 001 to 
be issued. 
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ENCSF (022) 

This function replaces the control statement file. If the file is not defined, the control 
statement file is cleared. 

If the file specified is empty, the following message is issued. 

FILE EMPTY. 

Macro Format :t 



lOCATION 


OPERATION 


VARIABLE SUBFIEIDS 




ENCSF 


addr, restore 



addr Address of the FET for the file that is to replace the 

current control statement file 

restore Address of word containing information on position of the 

current control statement file; optional parameter 

If the restore option is selected, the location must be in the following format. 

59 35 29 5 

restore 



cs 





current random address 


wc 



cs 

wc 



Control statement count 
Word count 



If the current random address specified is zero, the following message is issued. 
ILLEGAL RANDOM ADDRESS. 



t This macro is not available in SYSTEXT. The user must specify system.s text 
PSSTEXT or call common deck COMCMAC (refer to appendix A). 
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PSCSF (023) 

This function gives the user the ability to control the execution of the job control state- 
ments by positioning the next statement to be executed. 

Macro Format:! 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




PSCSF 


addr 



addr 



Address of the FET for the request 



FET+6 contains the parameters in the following format: 



59 



47 



23 



FET+6 



V////////A 


wc 1 



cs 
wc 



statement count 

Word count from the beginning of the file; if the word 
count specified exceeds the length of the file, the file 
is positioned at the beginning. 



t This macro is not available in SYSTEXT. The user must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix A). 
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Parameter 



Processing option (po) 



Word 
(FET+n) Position 



Description 



8 



47-36 Processing options; 



Bit Set 
42 



Description 



If set, toggles installation 
default setting of the flag 
which controls error 
correction activity in GE 
(6250 cpi) write mode. 
The setting selected is 
returned after tape assign- 
ment is complete. If the 
installation defaultf is 
(allow error correction) 
and the user does not 
toggle it or if the installa- 
tion default is 1 (disable 
error correction) and the 
user toggles it, a value of 
is returned indicating 
that hardware error 
correction is enabled. In 
this mode of operation, 
the system allows certain 
types of single-track 
errors to be written that 
can be corrected when the 
tape is read (on-the-fly 
correction). This is the 
recommended setting be- 
cause it provides efficient 
throughput, error recov- 
ery, and tape usage when 
writing GE tapes on 
media that are suitable 
for use at 3200 fci or 
6250 cpi. If the installa- 
tion default is 1 and the 
user does not toggle it or 
if the installation default 
is and the user toggles 
it, a value of 1 is re- 
turned indicating that 
hardware error correction 
is disabled. The system 
invokes standard error 
recovery processing when 
an on-the-fly error occurs 
when writing a GE tape. 
The system erases the 
defective portion of tape, 
thereby reducing the 
amount of data that can be 
stored on the tape. Only 
tape that is suitable for 
recording at 62 50 cpi 



t Contact installation personnel to determine the default setting. 
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Parameter 



Processing option (po) 



Word 
(FET+n) Position 



Description 



47-36 



Processing options; 
Bit Set 
(continued) 



Description 



42 should be used wlien this 
mode of operation is in 
effect. Refer to process- 
ing options G and H in 
section 10 of volume 1 for 
further information. 

43 If set, toggles installation 
default setting of the flag 
which controls the issuing 
of tape error messages to 
the user control point 
dayfile. The setting 
selected is returned after 
the tape assignment is 
complete. If the installa- 
tion default for the setting 
is 1 (issue all messages 
to user dayfile)-}- and the 
user does not toggle it or 
if the installation default 
for the setting is 

(only issue first and last 
message to user dayfile) 
and the user toggles it, a 
value of 1 is returned, 
indicating that all tape 
error messages are to be 
issued to the user control 
point dayfile. If the in- 
stallation default for the 
setting is and the user 
does not toggle it or 
if the installation default 
for the setting is 1 and 
the user toggles it, a 
value of is returned 
and only the first and last 
tape error messages are 
issued to the user control 
point dayfile. 

44 Not used. 



•f- Contact installation personnel to determine the default setting. 
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If a local file with the specified file name already exists (other than a VSN entry for the file), 
no assignment is made and job processing continues. An OPEN or POSMF is not performed 
to reposition an existing tape file. To assign the file to tape, the user should return the 
existing file to the system before issuing the LABEL request. 

If the file is to be used for checkpoint dumps, the checkpoint mode can be specified in 
FET + 7, bits 59 through 56. Refer to the format of FET+7 in the REQUEST macro 
(function 014). 



Example: 

The following example assigns a file to magnetic tape. The program performs the same 
function in assigning the tape as the following control statement. 

LABEL(TAPE1, VSN=NOSVSN, PO=R, D=HY, F=I) 
The tape is seven-track, 800 bpi, I format. The program reads file TAPEl. 



BUFL 


EQU 


3001B 


FET 


BSS 





TAPEl 


FILEB 


BUF, BUFL, LBL 




ORG 


FET+8 


FET8 


VFD 


6/20B,3/3,3/0.12/lGB, 6/0,6/0,24/lOOOB 


FET9 


VFD 


36/OHNOS VSN, 24/0 




VFD 


60/0 




VFD 


60/0 




VFD 


60/0 




VFD 


60/0 


BUF 


BSS 


BUFL 




LABEL 


FET 



READ 



FET 



GETFNT (025) 

The GETFNT macro generates a table of FNT/FST entries for local files. Refer to the 
NOS Systems Programmer's Instant, section 3, for the format of FNT/FST entries. 

For mass storage files, bytes 2 and 3 of the FST (bits 35 through 12) can be modified with 
either a random index (converted from current track and sector), or the file length (number 
of sectors). For tape files, the FST entry can be modified with MT in bjrte 1 (bits 47 
through 36) and the block number in bytes 2 and 3. 
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Macro Format: t 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




GETFNT 


addr 



addr 



Address of the PET 



GETFNT obtains its input parameters from FET+ 8, in the following format. 

59 47 41 23 17 

FET + 8 



nf 


Wa 


sb 


cb 


to 



nf 



sb 



Maximum number of two- word FNT/FST entries to re- 
turn to table. Table size must be at least (nf-2 + 1). 
Default is 2OO3 entries. 

File type selection bits. A bit set implies the corre- 
sponding file type is selected for entry into the table. 
All bits set to zero indicates selection of all file types. 
Bit positions and corresponding file types are as follows: 



Bit 


File Type 


Description 


41-38 


-- 


Unused 


37 


LOFT 


Local 


36 


SYFT 


System 


35 


FAFT 


Fast attach file 


34 


PMFT 


Direct access permanent file 


33 


PTFT 


Primary terminal 


32 


LIFT 


Library 


31 


-- 


Reserved 


30 


-- 


Reserved 


29 


-- 


Reserved 


28 


TEFT 


Timed/event rollout 


27 


PHFT 


Punch 


26 


PRFT 


Print 


25 


ROFT 


Rollout 


24 


INFT 


Input 



•f This macro is not available in SYSTEXT, The user must specify systems text PSSTEXT 
or call common deck COMCMAC (refer to appendix A). 
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cb 



Control bits; 



Bits 



Significance 



23-21 Unused. I 

20 If bit 20 is set, checkpoint file FNT/FST entries 

are returned to the table (FET length must be 
at least nine words). If bit 20 is not set (Q), 
checkpoint file FNT entries are returned in 
FET+9, instead of the table (FET length must 
be at least 13 words). 

19 If bit 19 is set, mass storage file FST entries 

are modified with file lengths in bytes 2 and 
3. If bit 19 is not set, the FST entry is mod- 
ified with random index in bytes 2 and 3. Bit 

18 must be or bit 19 is ignored. 

18 If bit 18 is set, no modifications are made on 

the FST entries. If bit 18 is not set, pertinent 
modifications are made (such as the block 
number for tape files or that specified by bit 

19 for mass storage files). 



ta 



Address of table 



Upon return from GETFNT, the FET is as follows: 
59 



FET +8 
+ 9 
+10 
+11 
+12 



la 



cfnt 



cfst 



acfnt 



acfst 



ia is less than zero if an error is encountered (bit 18 
of FET+8 not set) 



cfnt 

cfst 
acfnt 

acfst 



FNT entry of the checkpoint file; cfnt is zero if there 
is no checkpoint file; less than zero if more than two 
checkpoint files encountered (bit 20 of FET+8 not set) 

FST entry of checkpoint file 

FNT entry of the alternate checkpoint file; acfnt is zero 
if there is no alternate checkpoint file 

FST entry of the alternate checkpoint file 
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The following example enables the user to determine if a primary file exists and what its 
name is. Also, the FST is modified to contain the file length in bytes 2 and 3. 



BUFL 


EQU 


2001B 


FET 


BSS 





FILEl 


FILEB 


BUF, BUFL, (FET = 13) 


BUF 


BSS 


BUFL 


FET8 


VFD 


12/1,6/, 18/1000B,6/6, 18/TADDR 


TADDR 


BSSZ 


3 




SAl 


FETB 




BX6 


XI 




SA6 


FET+8 




GETFNT 


FET 




SAl 


TADDR 




ZR 


XI, NOP IF NO PRIMARY FILI 



PRIMARY (031) 

The PRIMARY macro enables the user to create or change a primary file (refer to the lAF 
Reference Manual or Time-Sharing User's Reference Manual for a description of primary 
files). The current primary file (if any) is changed to a local (LOFT) file and the local mass 
storage file specified in FET+0 is made the primary file. If the specified file does not exist, 
an empty primary file is created. 



Macro Format t 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




PRIMARY 


addr 



addr 



Address of the FET for the new primary file 



tThis macro is not available in SYSTEXT. The user must specify systems text PSSTEXT 
or call common deck COMCMAC (refer to appendix A). 



2-4-24 



60445300 L 



FILINFO (032) 

The FILINFO macro returns information about a file to a specified parameter block. 
Macro Form.at: 



lOCATION 


OPERATION 


VARIABLE SUBFIEIDS 




FILINFO 


addr 



addr 



Address of a five-word param.eter block 



Before the FILINFO macro is issued, the first word of the param.eter block must contain 
the following: 



59 



addr 



17 



local file name 


len 








len 



Length of parameter block (at least five words) 



If a file with the specified logical file name is not found local to the job, but a tape 
file with a seven-character name whose first six characters match that of the specified 
file name is found, then information is returned for that file. 



The standard parameter block returned has the following format. 

59 47 35 29 



17 



II 



oddr+O 


local file name (Ifn) 


len 





c 


+ 1 


dt 


status 


ft 


+ 2 


equipment no. 





+ 3 


file length in sectors 





current random address 





+ 4 


reserved 



c 

dt 



Completion bit (set when operation is complete) 

The 12-bit display code of the type of device on which 
the file resides (refer to appendix E) 

If a file is opened but not written on and it is a mass 
storage file that has not been allocated tracks on a 
specific allocatable device, the device mnemonic is 
binary 
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status 



Status bits; 

Bits 

47-24 
23 
22 
21 
20 
19 
18 
17 



16 

15 

14-13 

12 

11 

10 

9 

8 

7 

6 



Description 

Reserved 

File at EOlt 

File at EOFt 

File at BOI t 

Labeled tape file 

Nine-track tape file 

Seven-track tape file 

File open; if set, indicates a CIO'OPEN function 

has been issued on. the file without a subsequent 

CLOSE function 



File assigned 
File on mass 
Reserved 
File assigned 
File assigned 
File assigned 
File assigned 
File assigned 
File assigned 
File assigned 



to time- sharing terminal 
storage 

in execute mode ft 
in read/append mode ft 
in read/modify miodett 
in modify mode ft 
in append mode ft 
in write mode tt 
in read m.ode tt 



ft 



File type in one of the following octal values 



File Type Value 

Local 

Input 1 

Print 2 

Punch 3 

Direct access 4 

(Reserved) 5 

Primary 6 

Library 7 

Other 77 



tFile position is returned for mass storage files only. EOF status is returned if the last 
operation was a read, and EOF was encountered. 
IttR^f®^ to PFM Macro Parameter Conventions in section 5. 
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For mass storage files, bits 6 through 12 of the status field are set, depending upon 
the file permission mode in the file name table. For other files, only the write lock- 
out bit in the file name table is checked. If the write lockout bit is set, read-only | 
permission is assumed. If the write lockout bit is not set, read and write permission 
is set. Bits 8 through 12 apply only to mass storage files. If the following permission 
mode is set in the FNT, the indicated bits are set in the status field. 



FNT Mode 

Read 

Write 

Append 

Modify 

Read/m.odify 

Read/append 

Execute 



Status Bits Set 

6, 12 

6, 7, 8, 9, 12 

6, 8, 12 

6, 8, 9, 12 

6, 10, 12 
6, 11, 12 
12 



For example, if read mode is set in the FNT, the user can read (bit 6 set) or execute 
(bit 12 set) the file. 

Word 4 (addr+4) of the parameter block is currently not used; however, it is reserved 
for future expansion of the FILINFO macro. 

The FILINFO macro optionally returns additional information for tape files. If the length 
(len field in addr+0) of the FILINFO parameter block is greater than five, tape file informa- 
tion is returned corresponding to key values in each word after addr+4. The key words 
begin at addr+5 of the parameter block and can be in any order. Keys are set by the user in 
bits 4 through of each key word and are returned unaltered after the request is processed. 
Bit 5 of the key word is set, and data fields are zeroed on return if the key is unknown to 
the system or is not applicable to the file type specified in addr+1. Key words with zero 
keys are ignored. 



The following keys return the corresponding key words. 

Keyf Returned Key Word for Tape File 



1 



14, 



59 














II 




5 








f 


1 


59 










17 II 8 5 








e 


Itype 


den 


cv 


2 


59 




47 




23 


II 5 








block size 


po 


noise 


14 



tThe symbols for each key value are defined in common deck COMSLFM. 



60445300 M 



2-4-27 



Field Key Bits Description 

f 1 11-6 Tape format: 

Internal (I) 



1 System internal (SI) 

2 Foreign (F) 

3 Stranger (S) 

4 Long block stranger (L) 

e 2 18 If set, error processing is inhibited (same as bit 14 in 

po field). 

Itype 2 17-12 Label type: 

Unlabeled 

1 Standard label (AiNSI 1969 standard) 
14B Nonstandard label 

den 2 11-9 Tape density: 

1 556 bpi (seven-track) 

2 200 bpi (seven-track) 

3 800 bpi (seven-track) or 800 cpi (nine-track) 

4 1600 cpi (nine-track) 

5 6250 cpi (nine-track) 

cv 2 8-6 Conversion mode:t 

BCD conversion (seven-track) 

1 ASCII conversion (nine-track) 

2 EBCDIC conversion (nine-track) 

block 14p 47-24 Maximum block size in central memory words. Always 

size 1000 octal for I and SI format tapes. For F format 

tapes, the block size is calculated from the FC or C 
parameter value specified on the tape assignment control 
statement (refer to section 10 of volume 1). For S and 
L format tapes, the block size returned is the size used 
on the last CIO operation, as determined from the de- 
fault block size, mlrs field in the FET, or CIO buffer 
size (refer to appendix J). The field is zero if no 
previous CIO function has been issued on the tape file. 
Refer to appendix J for further information. 



•f" Conversion mode of labels (if any) and coded data (if any). This does not indicate 
whether the data on the tape is coded or binary. 
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Field Key Bits Description 

po 14 23-12 Processing options. Refer to the description of the po 

^ field for the LABEL macro in section 4. The 12 bits in 

each field have the same respective definitions. 
If po bit 18 (corresponding to po bit 42 for the LABEL 
macro) is set upon return from the FILINFO macro, 
GCR hardware write error correction is disabled. 

If po bit 19 (corresponding to bit 43 for the LABEL 
macro) is set upon return from the FILINFO macro, the 
issuing of all error recovery messages to the user day- 
file is enabled. 

noise 14o 11-6 Noise size in frames. 

o 

If the specified file is not local to the user's job, words 1 through 4 of the parameter block 
are cleared. All other fields (including words containing keys) are unchanged. 

If any of the paramieter block is beyond the user's field length, the following m.essage 
is issued. 

ADDRESS OUT OF RANGE. 

If the length specified for the param.eter block is not at least five words, the following 
message is issued. 

FET TOO SHORT. 

If this function is issued as an RA+1 request without using the FILINFO macro, the comple- I 
tion bit must be set to 0. If it is not, the following message is issued. I 

PARAMETER BLOCK BUSY. 

If the file is busy (cannot be interlocked), the following m.essage is issued. 

I/O SEQUENCE ERROR. 
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PERMANENT FILE MANAGER 



Permanent file manager (PFAT) processes all permanent file requests. The format of 
the RA+1 call to PFAI is as follows: 



59 



40 35 



23 



17 



RA + I 



PFM 



^'"m, 



code 



addr 



r 
code 

addr 



Auto recall bit (must be set) 
Function code 

Address of the FET 



The FET used by all PFM requests is formatted as follows: The mnemonics (CFSN, for 
example) are defined in common deck COMSPFM. 



59 56 53 



FET + 
+ I 
+ 2 
+ 3 
+ 4 
+ 5 
+ 6 
+ 7 
+ 8 
+ 9 
+ 10 
+1 I 
+ 12 
+ 13 
+ 14 
+ 15 




W//////////////////////////////A 




CFSN 



CFCN 



CFPN 
CFCT 
CFMD 



CFPR 
CFBR 
CFSS 



Ifn Local file name 

dt Device type 

up User processing bit (bit 45) 

ep Error processing bit (bit 44) 

rt Real-time processing bit (bit 43) 

i FET length minus 5 

pfn Permanent file name 

ct File category (refer to Permission Modes, File Categories) 
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m File access mode (refer to Permission Modes, File Categories) 

un Alternate user number 

dn Device number for CATLIST option (range is 1 to 773) 

s Number of PRUs (octal) desired for the file 

pwd Optional file password 

erad Error message return address 

ucw User control word 

pn Pack name of auxiliary device 

unit Number of units of multiunit device 

nfn New file name 

pr Preferred residence for file 

Ijr Backup requirement for file 

ss Subsystem 

For a more detailed description of the FET, refer to the discussion of the FET in section 2. 

After a request to PFM is complete, the first word of the FET contains the following infor- 
mation. 



59 17 



FET + 



Ifn 



at 



Ifn Local file name 

at Abnormal termination code 

c Bit is set ta 1 upon completion of the request 

The FET length may be 5 words, if no special options are required, or up to 16 words, 
depending on the special options required. 

When a PFM macro request is issued, the parameter values specified are placed in their 
corresponding fields in the FET. If a field is and a default is defined by PFM for that 
field, the default is used (refer to exceptions listed below for CHANGE processing). 

If the permanent file name is not specified in a macro, FET+8 contains the permanent file 
name. If XI is specified, XI contains the permanent file name left-justified and zero-filled. 
If FET+8 does not contain a file name, the contents of FET+0 is used as the permanent file 
name. 

If the file category and/or file access mode are not specified in a macro, FET+8 contains 
these values. On a CHANGE request, these fields must be if they are not to be changed. 
Whenever a field is specified in a CHANGE request, its upper bit must be set (bit 11 for 
file category and bit 5 for file mode). 

If the alternate user number is not specified in a macro, FET+9 contains the name of the 
alternate catalog. If X3 is specified, X3 contains the user number left-justified and 
zero-filled. 

If the file password is not specified in a macro, FET+10 contains the file password. If X2 
is specified, X2 contains the file password left-justified and zero-filled. On a CHANGE 
request, bits 59 through 18 of FET+10 must be set if the password is not to be changed. 

If the user control word is not specified in a macro. FET+11 contains the user control in- 
formation. On a CHANGE request, bit 59 must be set if FET+11 contains data for PFM to 
process. 
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If the pack name is not specified in a macro, FET+12 contains the pack name. 

If the new file name is not specified in the CHANGE macro, FET+13 contains the new file 
name. 

If the preferred residence, backup requirement, and /or subsystem are not specified in a 
macro, FET+15 contains these values. On a CHANGE request, a field must be if it is 
not to be changed. Whenever the subsystem field is specified in a CHANGE request, bit 53 
must be set. 

The address of the FET must be supplied in the addr parameter. The call to PFM must 
be made with the auto recall bit set. 

The common decks required for an absolute assembly of a program containing PFM requests 
are COMCPFM and COMCSYS. In order to use the mnemonics defined for PFM FET ad- 
dresses, permission modes, file categories, error codes, or functions, common deck 
COMSPFM is required for absolute or relocatable assemblies. Function mnemonics are 
specified in the macro descriptions. 



ERROR PROCESSING 

The user can issue requests to PFM and have control returned if certain error conditions 
occur. To do this, the error processing bit (ep) must be specified in FET+1. The error 
codes are returned in the abnormal termination (at) code field of FET+0 (bits 17 through 
10). If the user specifies erad in FET+10, the error message is returned at this address 
instead of being issued to the user's dayfile. A maximum of three central memory words 
are returned. System errors are issued to the system and error log dayfiles regardless 
of the erad specification. 

The following error codes are returned in the abnormal termination code field. It is recom- 
mended that the error code mnemonics defined in common deck COMSPFM be used in testing 
these error conditions. The mnemonics are qualified by symbol ERRMSG. For example, to 
set the B7 register to the value of the FBS mnemonic, use the following instruction. 

SB7 /ERRMSG/FBS 
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Error 
Code 



Mnemonic 



FBS 



FNF 



Description 

The specified direct access file is attached with conflicting 
mode (file busy). 

One of the following: 

• The specified permanent file could not be found. 

• The specified user number could not be found. 

• The user is not allowed to access the specified file. 



If this error occurs in response to a SAVE, REPLACE, or 
APPEND macro, the specified local file is not attached to 
the control point or is an execute-only file. 

EFL The file specified on a SAVE, REPLACE, or APPEND 

macro contains no data. 

NMS The file to be saved is not on mass storage; the first track 

of the file is not recognizable. 

FAP The user has already saved or defined a file with the name 

specified. 

IFT The user attempted to define a file that is not a local file. 

FNE File name contains illegal characters. 
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Error 
Code Mnemonic 



10 



11 



lUA 



IDR 



12 



FTL 



13 



ILR 



Description 

The user is not validated to create direct access or indirect 
access files or to access auxiliary devices. 

The device type (r parameter in macro calls) specified on a 
request for an auxiliary device cannot be recognized or does 
not exist in the system. 

If the auxiliary device specified by the pn parameter is not 
the same type as the system default, the r parameter must 
be included; if not, this error code is returned. 

The local file specified for a SAVE, REPLACE, or APPEND 
request exceeds the length allowed, or the direct access | 

file specified for an ATTACH in WRITE, MODIFY, or 
APPEND mode exceeds the direct access file length limit 
for which the user is validated. 

One of the following: 

• Illegal function code passed to PFM. 

• Illegal permit mode or catalog type specified. 

• CATLIST request has permit specified without a 
file name. 

• PERMIT attempted on a public file. | 

• DEFINE attempted with alternate user number in 
FET. 



14 



15 



16 

17 
20 

21 



PFN Access to the permanent file device requested is not 

possible. 

DAD The device on which the file resides may not contain direct 

access files because: 

• The device is not specified as a direct access de- 
vice in the catalog descriptor table. 

• The device is not specified as ON and initialized in 
the catalog descriptor table. 

• The device is a dedicated indirect access perma- 
nent file device. 

PFA Because a permanent file utility is currently active, the 

operation is not attempted; the user should retry the 
operation. 

DTE An error occurred in a read operation during a file transfer. 

COF The number of files in the user's catalog exceeds the limit 

(refer to LIMITS control statement, volume 1, section 6). 

COS The cumulative size of the indirect access files in the user's 

catalog exceeds the limit (refer to LIMITS control statement, 
volume 1, section 6). 
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Error 
Code 

22 



23 



32 



33 
34 

35 

36 
37 



Mnemonic 



SPN 



lOE 



24 


LFL 


25 


PRL 


26 


PLE 


27 


-- 


30 


RSE 


31 


TKL 



FLE 



RIN 
DAF 

RPE 

ABT 

MSE 



40 


EDA 


41 


EPT 


42 


EDP 



Description 

The number of PRUs specified via the s parameter on the 
DEFINE macro is not available. 

A request is attempted on a local file that is currently 
active. This error can occur, for example, if the user 
creates two FETs for the same file and issues a second 
request before the first is complete. 

The job's local file limit has been exceeded by an attempt 
to GET or ATTACH the file. 

The job's mass storage PRU limit is exceeded during prep- 
aration of a local copy of an indirect access file. 

Permit limit is exceeded for a private file. 

Reserved. 

The resource executive detected a fatal error. 

No allocatable tracks remain on equipment xx, where xx is 
the EST ordinal. 

The length of a file does not equal the catalog length; the 
action taken depends on the type of request issued. 



Request 
GET 

SAVE 



Action 

A local file is created with length being 
the actual length retrieved. 

If file length is longer than TRT specifi- 
cation, file is truncated. 



REPLACE Same as for SAVE. 

PERMIT random address error. 

The system sector data for the file does not match the 
catalog data. 

The same file is found twice during a catalog search. This 
error can occur for APPEND or REPLACE requests after a 
file is found and purged and the catalog search is continued. 

Error flag detected at PFM control point. 

An error is encountered in reading or writing a portion of 
the permanent file catalog or permit information. A write 
error encountered during the device to device transfer of an 
indirect access file. 

Error in data for file. 

Error in permit entries for file. 

Combination of errors 40 and 41. 
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Error 
Code 

43 



44 



45-47 
50 

51 
52-70 

71 

72 

73 

74 

75 

76 

77 
100 

101 

102 

103 

104 



Alnemonic Description 

FI.C An error in the EOI position of the file was detected by- 

recovery routines. 

NEM PFM detected a fatal RESEX error. PFM does not issue a 

message since RESEX has issued an appropriate message. 
If the error processing (ep) bit is set and the erad field of 
FET+10 contains a valid address, the message RESEX 
issues is returned to that address. 

Reserved. 

FSE Verification of the file structure or owner identification 

failed. 

SSE Error in system sector of indirect access file. 

Reserved. 

PPE The file does not reside on disk. An unrecoverable error 

was detected when attempting to stage the file to disk from 
alternate storage. 

PSI The file does not reside on disk. It is currently being 

staged from alternate storage to disk. 

PWE The file must be staged from alternate storage to disk, but 

the subsystem is not currently available to perform the 
stage operation, 

FIN The file is currently not available for WRITE, MODIFY, 

or APPEND modes of access because a system utility has 
the file attached in utility mode. 

FDA The file is a direct access file and an indirect access file 

operation was requested. 

FIA The file is an indirect access file and a direct access file 

operation was requested. 

Reserved. 

SGD The file does not reside on disk and must be staged from 

alternate storage to disk. 

IPA The device number, track, and sector specified as the 

permanent file catalog (PFC) address are invalid. 

PVE The creation date and time, user index, or alternate 

storage address do not agree with the current PFC contents. 

FND Access to a file that does not reside on disk is not per- 

mitted with the current function. 

INA A software interlock is currently not available to a request 

specifying both ep and up processing options. 



60445300 M 



2-5-7 



Error 
Code Mnemonic 



105 

106 
107 
110 

111 



AIO 



ASE 



FTF 



ICU 



PEA 



Description 

The disk space for a file cannot be released when the alter- 
nate storage image is labeled obsolete or the alternate 
storage address is not specified in the PFC. 

The disk space for a file cannot be released when a perma- 
nent error status is set for the alternate storage file image. 

File name table (FNT) space is currently not available for a 
request that has both ep and up processing options set. 

Verification of the PFC prohibits the setting of a new alter- 
nate storage address when the alternate storage address is 
defined and not labeled obsolete. Also, an existing valid 
disk address cannot be replaced in the PFC entry. 

The PFM activity count is currently at its limit. This condi- 
tion is reported to the requesting program only if both the ep 
and up processing options are set. 



PFM MACRO PARAMETER CONVENTIONS 

Several methods are available to the user to specify the m, ct, ss, br, and pr parameters 
in PFM macros. The user can either specify an alphabetical key or an address that contains 
an integer value that corresponds to a key. If an address is specified, the value must be 
right-justified and zero-filled in a 60-bit word. The values can be established with the 
mnemonics in the following list. The user must call common deck COMSPFM to use these 
mnemonics (relocatable or absolute assembly). The valid mnemonics (if any), keys, and 
values for the m, ct, ss, br, and pr macro parameters are listed. 



Parameter Mnemonic Key 

m 

PTWR W 



PTRD R 



PTAP A 



PTEX E 



PTNU N 



PTMD M 



Value Description 

File or user permission mode: 

Allows the user to write, read, append, 
execute, modify, and/or purge the file. This 
mode can be specified for direct or indirect 
access files. 

1 Allows the user to read and/ or execute the 
file. This mode can be used for direct or 
indirect access files. 

2 Allows the user to append information to the 
end (EOT) of the file and to read or execute 
the file. This mode can be specified for 
direct or indirect access files. 

3 Allows the user to execute the file. This 
mode can be specified for direct or indirect 
access files. 

4 Removes permission previously granted via 
PERMIT macros. This naode can be speci- 
fied for direct or indirect access files. 

5 Allows the user to modify, append, read, 
and/or execute a direct access file. Adding 
new information within the existing boundaries 
of the file is legal, but the file size must be 
maintained. 



2-5-{ 



60445300 K 



Parameter Mnemonic Key Value 



Description 



PTRM RM t 6 



PTRA 



RA t 7 



ct 



FCPR 



FCSP 



P 



S 1 



Allows the user to read and/or execute a 
direct access file with the implication that 
another user may currently be accessing the 
same file in M (modify) or A (append) mode. 
For indirect access files, this mode is the 
same as R (read) mode. 

Allows the user to read and/or execute a 
direct access file with the implication that 
another user may currently be accessing the 
same file in A (append) mode. For indirect 
access files, this mode is the same as R 
(read) mode. 

File category: 

Private. Private files are available for 
access only by the originator or those to 
whom the originator has explicitly granted 
permission (refer to the PERMIT macro). 

Semiprivate." Semiprivate files are avail- 
able for access by all users who know the 
file name, user number, and file password. 
The system records in the originator's 
catalog the user number of each user who 
accessed the file, the number of accesses, 
and the date and time of the last access. 



FCPB PU 2 Public. Public files are available for 

access by all users who know the file 
name, user number, and file password. 
The system records the num^ber of times 
the file was accessed but does not record 
user numbers or the last access date and 
time. 



•f" Special care should be taken when using modes RM or RA. Programs using access 
techniques (either CIO or CYBER Record Manager) which do not expect concurrent 
updating of a file may get erroneous results if these modes are used. CRM Advanced 
Access Methods (refer to the AAM Reference Manual) do not expect concurrent updating of 
a file by another user. Therefore, if a file has been attached in either RM or RA mode 
and these access methods are being used, a warning message is issued to the user stating 
that the file is bad when, in fact, it is not. 
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Parameter 


Mnemonic 


Key ^ 


v^alue 


ss 






-- 


NULL 







-- 


BASIC 


] 




-- 


FORT 


2 




-- 


FTNTS 


3 




-- 


EXEC 


4 




-- 


BATCH 


5 


brt 










BRNO 


N 


1 




BRAL 


Y 


2 




BRMD 


MD 


3 



prt 



RSMS 
RSNP 



M 
N 



Description 

Subsystem indicator: 

Null subsystem. 

BASIC subsystem. 

FORTRAN Version 5 subsystem. 

FORTRAN Extended Version 4 subsystem. 

Execute subsystem. 

Batch subsystem. 

Backup requirement: 

Backup is not required on a dump tape. 

Backup is required on a dump tape. 

Backup is required on a dump tape only 
if the file is not resident on MSF. 

Preferred residence: 

The file should reside on MSF when it 
is not being accessed. 

No preferred residence for the file. 



t If this parameter is omitted or a value of is specified, PFM uses the installation default 
value. 
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AUXILIARY DEVICE REQUEST 

Unless the user explicitly declares otherwise, all permanent files reside on family devices. 
As stated in section 2, volume 1, the user may wish to supplement the mass storage pro- 
vided by his family devices by retaining his files on auxiliary devices. There are four 
parameters (pn, r, un, and pwd) that uniquely identify file pfn on an auxiliary device. 

• The pn parameter specifies the one- to seven-character system-defined pack name 
of the auxiliary device. The device can be either public or private, as defined by 
the installation. 

• The r parameter specifies the type of auxiliary device on which the file resides or 
is to reside. An auxiliary device is any supported device which an installation 
defines as auxiliary; it need not be physically removable as the pack name implies. 

If the device is physically removable, r is Din, DJn, DKn, DLn, DMn, or DQn as 
described for Equipment Codes in appendix E. 

If the user needs two or more physically removable auxiliary devices at any one 
time during his job, he must include a RESOURC control statement (refer to section 
6, volume 1). An installation can provide additional continuous storage on a DI, 
DJ, DK, KL, DM, or DQ type device by combining physical units into one logical 
unit. A device so defined is known as a multiunit device. To specify such a device, 
the r parameter must include the number of units. For example, if four 844-21 
units have been combined as one multiunit device, the r parameter must be DI4. If 
it is not, the job step is aborted and PFM error message lis (IDR) is issued to the 
user's dayfile. 

ILLEGAL DEVICE REQUEST, AT addr. 

However, if r is DI, DJ, DK, DL, DM, or DQ but n is omitted, the unit count is 
assumed to be 1. 

The r parameter is required only if the desired device has a device type different 
from that of the available device, and the installation has defined the desired device 
as removable. However, if the user always specifies the r parameter, he can be 
sure that he is accessing the proper device. If r is specified and it conflicts with 
that of the available device, PFM error message II3 (IDR) is issued. For all PFM 
macros, if pn is specified but the device is not available, the job is aborted. By 
setting the error processing bit (FET + 1, bit 44), the user can bypass the abort and 
direct the system to make available the device with packname pn and device type r. 
If both the error processing bit and the user processing bit (FET + 1, bit 45) are set, 
control is returned to the user when the device is unavailable and error code Mg 
(PFN) is set in FET+0. 

• The un parameter specifies the one- to seven-character optional user number. If 
the device is public, files are accessed in the same manner as specified for family 
devices. That is, the un parameter must be included only if the user wishes to 
access files which another user has explicitly or implicitly permitted him to use. 
If the device is private, there is only one owner. All other users who have the 
proper validation can access files on the device, but the system prevents them from 
creating files. 

• The pwd parameter specifies the one- to seven-character password associated with 
the file. As with files on family devices, the pwd parameter must be included only 
if the originator requires that a password be specified. 
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SAVE (001, CCSV) 

The SAVE macro enables the user to retain a copy of a temporary mass storage file in the 
permanent file system as an indirect access file. The original file is rewound when completed, 

Macro Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




SAVE 


addr, pfn, pwd, ucw, ct, m, pn, r, fo, ss, bi 



addr 
pfn 

pwd 

ucw 

ct 



Address of the FET; the local file name must be set in FET+0. 

Address containing the name of the file; name the file is given 
in the permanent file catalog. 

Address containing the password to be placed with the file in 
the permanent file catalog. 

Address containing user control word to be placed with the file 
in the permanent file catalog. If this word exists in the catalog, 
it is returned to FET+11 when the file is accessed (default = 0). 



File category: 


ct 


Description 


P 


Private file (default value) 


S 


Semiprivate 


PU 


Public file 



m 



Refer to PFM Macro Parameter Conventions in this section 
for further information. 

File mode. This parameter defines the type of access alter- 
nate users may have for semiprivate or public files. 

m Description 

W Read, write, purge, and execute (default value) 

R Read and execute 

A Append 

E Execute 

N None 

RM Same as R for indirect access files 

RA Same as R for indirect access files 

Refer to PFM Macro Parameter Conventions in this section 
for further information. 
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pn Address containing one- to seven-character pack name of the 

auxiliary device on which the file is to be saved. 

r Type of auxiliary device on which the file is to be saved (refer 

to the DEFINE macro). 

fo Family option: 

IP The pack name specified by a PACKNAM macro or 

pn parameter is ignored. PFM accesses the user's 
family. 

DF The pack name specified by a PACKNAM macro or 

pn parameter and the family name specified on the 
USER statement are ignored. PFM accesses the 
system default family. This option can be used 
only by programs that have an SSJ= entry point, 

ss Subsystem indicator. This indicator causes automatic sub- 

system selection when the file is retrieved using the OLD 
macro or control statement, 

ss Description 

NULL Null subsystem 

BASIC BASIC subsystem 

FORT FORTRAN Version 5 subsystem 

FTNTS FORTRAN Extended Version 4 subsystem 

EXEC Execute subsystem 

BATCH Batch subsystem 

Refer to PFM Macro Parameter Conventions in this section 
for further information. 

br Backup requirement. Specifies whether the file is to be backed 

up on a dump tape when the site dumps permanent files. 

br Description 



Y The file must be backed up on the dump tape 

MD For the SAVE macro, MD performs the same 

function as Y 

N The file is not to be backed up on the dump tape 

Refer to PFM Macro Parameter Conventions in this section 
for further information. 
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Example 1: This example saves local file FILE in the permanent file system as a public 
file named DATA with read permission. The file will be backed up on a 
dump tape when the site dumps permanent files. 



SAVE 



FILE,PF,..PU,R,.,.. Y 



FILE FILEB BUF, BUFL, (FET=16) 

PF VFD 42/OLDATA, 18/0 

Example 2: This example performs the same function as example 1. 

XTEXT COMSPFM 

SAl PF 

SAVE FILE, XI, , , FCAT, FMOD, , , , , BACK 



FCAT 


CON 


FCPB 


FMOD 


CON 


PTRD 


BACK 


CON 


2 


FILE 


FILEB 


BUF, BUFL, (FET = 16) 


PF 


VFD 


42/OLDATA, 18/0 



Example 3: In this example, local file TAPEl is saved in the permanent file system as 

a private file named PTAPEl with null permission. The subsystem indicator 
is set to the batch subsystem. 



SAVE 



F, PF, , , P, N, , , , BATCH 



F 


BSS 


TAPEl 


FILEB 


PF 


VFD 





BUF, BUFL, (FET=16) 

42/OLPTAPEl, 18/0 



GET (002, CCGT) 

The GET macro enables the user to generate a temporary copy of an indirect access per- 
manent file. If a local file by the same name already exists, it is returned as if the UNLOAD 
macro had been issued even if the GET is unsuccessful. The new file is set to rewound 
status. No interlock is provided to prevent other users from obtaining copies of the same 
file simultaneously. 
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• Determine the alternate user information for a specified file that an alternate user 
can access or has accessed in his catalog (permit data). 

For the first type of request, the permanent file catalog entries of all files or a single 
specified file in the user's catalog are returned. 

The format of the permanent file catalog entry is as follows: 





59 


56 


53 


47 


44 


41 


38 


35 


23 


17 


II 


word 


file name 


user index 


1 


file length 


w///m 


track 


sector 


2 


random Index 


creation date and time 


3 


access count 


data modification date and time 


4 


ct 


mode 


ef 


ec 


dn 


lost access date and time 


5 


^f^^^^:^^^^^^^^^:^^ 


control modification dote and time 


6 


pr 


br 


ss 


y/////////A 


utility control date and time 


7 


file password 


mw////M. 


8 


af lags 


y///M 


alt 


as a 


9 


^^mm^^^^m^m^m^^mmmm^ 


10 


^m^^mm^:m^mmmm^;mm^ 


II 


w///////////////////////^^^^^^ 


12 


^mmm^m^^m^^^^^mM^^^m^^m^ 


13 


W///////////////////////^^^^^^^ 


14 


user control word 


15 


reserved for installation 



FCFN, FCUl 

FCLF.FCBT.FCBS 

FCRI, FCCD 

FCAC, FCMD 

FCCT, FCAM.FCEC 

FCKD 

FCRS, FCBR.FCFS, FCUD 

FCPW 

FCAF, FCAT, FCAA 



FCEO, 
FCA-D 



FCVC 
FCIW 



file name 

user index 

file length 

track 

sector 

random index 

creation date 
and time 

access count 



Permanent file name. 

User index of file creator. 

Length in PRUs of the file. 

Beginning track of file. 

Beginning sector of file (4xxx for a direct access file). 

Random disk address of permit sector. 

Date and time (yymmddhhmmss in octal) when this file was 
first entered on the permanent file system. The year (yy) 
is biased by 70. 

Count of accesses to file. 



data modifica- Date and time (yymmddhhmmss in octal) when the data in this 
tion date and file was last modified. The year (yy) is biased by 70. For 
time direct access files this field is updated when the file is 

attached in a modifiable mode, whether or not the file is 

actually modified. 
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ct File category (refer to PFM Macro Parameter Conventions 

for further information). 

mode File mode (refer to PFM Macro Parameter Conventions for 

further information). 

ef Error flag: 

No error. 

1 EOI changed by recovery, 
ec Error code: 

No error, 

1 Error in data for file. 

2 Error in permit entries for file. 

3 Error in data and permit entries for file. 

4 File length error. 
5-7 Reserved. 

dn Device number (0 through 773); each device within a family 

of permanent file devices is identified by a device number, 

last access Date and time (yymmddhhmmss in octal) when this file was 

date and time last accessed. The year (yy) is biased by 70, 

control modi- Date and time (yymmddhhmmss in octal) when the control 
fication date information (catalog entry and permit record data) for this 
and time file was last updated. The year (yy) is biased by 70. 

pr Preferred residence for file (refer to PFM Macro Parameter 

Conventions in this section for further information). 

br Backup requirement for file (refer to PFM Macro Parameter 

Conventions in this section for further information). 

ss Subsystem code for this file (refer to PFM Macro Parameter 

Conventions for futher information), 

utility control Date and time (yymmddhhmmss in octal) used to determine 
date and time this file's candidacy for being dumped by permanent file 
utilities. The year (yy) is biased by 70, 

file password Optional password. 

aflags Alternate storage flags; used with the asa field and meaningful 

only if the file resides on an alternate storage device (as 
indicated by the alt field); refer to the NOS System Maintenance 
Reference Manual for a complete description of this field. 

alt Alternate storage type: 

No alternate storage copy of the file exists 

1 An alternate storage copy of the file resides on MSF 

asa Alternate storage address; meaningful only if an alternate 

storage copy of the file exists (as indicated by the alt field); 
if asa is 0, the file does not reside on alternate storage; 
refer to the NOS System Maintenance Reference Manual for 
a complete description of this field. 
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user control 
word 



User control information (FET+11). 



For the second t3TDe of request, the catalog entries (except user index and file password) for 
all files or a single specified file that the user may access in an alternate catalog are 
returned. 

For the third type of request, all alternate user access entries for a specified file are re- 
turned. The format of an alternate user access entry is illustrated. 



59 






41 


35 




7 







usernum 


m 


WM 


m, 


ac 


m 


ad 


at 



usernum 
ac 

m 



ad 

at 



Alternate user number. 

Number of accesses the alternate user has made 
to the file. 

Permission mode (bit 40 set if this was an 
• accounting permit and was not created by a 
PERMIT control statement or macro; bit 40 
clear indicates an explicit permit set by PERMIT 
statement or macro; bits 39 through 36 are same 
as mode described in first type of request). . 

The last date the user accessed the file. 

The time of day the user last accessed the file. 



Macro Format rf 



LOCATION 



OPERATION 



CATLIST 



VARIABLE SUBFIELDS 



addr, pfn, un, m, pn, r, fo, sr 



addr 
pfn 



un 



Address of the FET for the CATLIST function. 

Address containing the file name; if this parameter is 
omitted, CATLIST information for all files is returned. 

Address containing the name of the alternate user catalog to 
be searched for the catalog information. If un is omitted, 
the user's own catalog is searched. 



f This macro is not available in SYSTEXT. The user must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix A). 
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m If this parameter is the letter M, alternate user access informa- 

tion for file pfn is returned. If this parameter is specified, the 
pfn is required and un is ignored. 

pn Address containing one- to seven-character pack name of the 

auxiliary device that contairts catalog information for all users 
with information on that device, 

r Type of auxiliary device identified by the pn parameter 

(refer to the DEFINE macro). 

fo Family option: 

IP The pack name specified by a PACKNAM macro 

or pn parameter is ignored. PFM accesses the 
user's family. 

DF The pack name specified by a PACKNAM macro 
or pn parameter and the family name specified 
on the USER statement are ignored. PFM 
accesses the system default family. This option 
can be used only by programs that have an SSJ= 
entry pointo 

sr Request CATLIST of files on device number dn (FeT+9, 

bits 17 through 12). 
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If the status returned in FET+0 (addr parameter of the CATLIST macro), bits 9 through 
0, is 0033 (EOF encountered), the user should reissue the CATLIST macro after the 
buffer of entries has been processed (refer to example 1). The user should continue 
this until a status of 1033 (EOI encountered) is returned. CATLIST uses the current 
random index field (FET+6, bits 59 through 30) to keep track of its position for con- 
tinued calls. If the user changes this field, the results of a CATLIST request may be 
undefined. 

"Information is placed in the buffer starting at IN until IN = LIMIT minus 1, at which 
time buffer full (0033) status is set in FET+0. PFM does not process the buffer cir- 
cularly; therefore the user must reset IN=OUT=FIRST before reissuing the CATLIST 
macro. 

The following examples assume that PSSTEXT is specified at assembly. 

Example 1: The following program creates a binary file named F with permanent file 
catalog entries for all files in the user's catalog. 

CAT 





IDENT 


CAT 








ENTRY 


START 








SYSCOM 


Bl 






F 


FILEB 


BUFF, 101 B 




G 


FILEB 


BUFG,101B,FET=10D 


START 


SBl 
MXO 


1 
SOD 






STAl 


CATLIST G 








SAl 


G 




DETERMINE ERROR CODE 




BXl 


-X0*X1 




(X1)=ERR0R CODE 




SXl 


X1-1033B 






ZR 


XI , STA2 




IF EOI (CATLIST COMPLETE) 




READW 


G,WBUF, 


lOOB 






WRITEW 


F,WBUF, 


lOOB 






SAl 


G+Bl 




RESET FET POINTERS 




SX7 


XI 








SA7 


Al+Bl 




SET IN=FIRST 




SA7 


A7+B1 




SET OUT=FIRST 




EQ 


STAl 






STA2 


SAl 


G+2 




(X1)=IN 




SA2 


Al+Bl 




(X2)=0UT 




1X5 


XI -X2 




(X5)=W0RDS IN CATALOG ENTRY 




READW 


G,WBUF, 


X5 






WRITEW 


F,WBUF, 


X5 






WRITER 


F 








ENDRUN 








BUFF 


BSS 


lOlB 






BUFG 


BSS 


lOlB 






WBUF 


BSS 


lOOB 







END 



START 
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Example 2: The following example returns all access information for file DATA013. 

CATLIST F,PF. ,M 



F 
PF 



FILEB 
VFD 



BUF, BUFL, (FET = 10D) 
42/0LDATA013, 18/0 



Example 3: This example returns a list of all files that the user can access in the catalog 
of user USERABC. 



CATLIST 



F,,AUN 



F 

A UN 



FILEB 
VFD 



BUF, BUFL, (FET=10D) 
42/OLUSERABC, 18/0 



PERMIT (005, CCPM) 

The PERMIT macro enables a user to explicitly permit another user to access a private 
file in his permanent file catalog. If the user wishes to remove permission previously 
granted, the negate mode should be selected. 

Macro Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELOS 




PERMIT 


addr, pfn, un, m, pn, r, fo 



addr 
pfn 



Address of the FET; the local file name must be set in 
FET+0. 

Address containing the name of the file; name of the file is 
given in the permanent file catalog. 
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m Mode of permission being granted; if no mode is specified, 

W (write) is assumed. 

m Description 



W Read, write, purge, and execute (default value). 

R Read and execute. 

A Append. 

E Execute. 

N None. 

M Modify, append, read, and/or execute. 

RM Read and/or execute, allow modifications, 

RA Read and/or execute, allow extensions. 

Refer to PFM Macro Parameter Conventions in this section 
for further information. 

pn Address containing one- to seven-character pack name of 

the auxiliary device on which the specified file resides. 

r Type of auxiliary device identified by the pn parameter 

(refer to the DEFINE macro). 

fo Family option: 

IP The pack name specified by a PACKNAM 

macro or pn parameter is ignored. PFM 
accesses the user's family. 

DF The pack name specified by a PACKNAM 

macro or pn parameter and the family name 
specified on the USER statement are ignored. 
PFM accesses the system default family. 
This option can be used only by programs 
that have an SSJ= entry point. 

An example of the use of this macro is: 
PERMIT F, PF.AUN.A 

F FILEB BUF,BUFL,(FET = 10D) 

PF VFD 42/0LDATA012, 18/0 

AUN VFD 42/OLUSERABC, 18/0 

This allows user USERABC to have append permission to file DATA012. 
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REPLACE (006, CCRP) 

The REPLACE macro enables the user to place a copy of the specified local mass storage 
file in the permanent file system as an indirect access file. If an indirect access perma- 
nent file with the specified name already exists in the catalog, that file is purged and the 
new file placed in the catalog as the same type of file. If the file does not exist in the 
catalog, the new file is placed in the catalog as a private file. Permission information and 
alternate user access data are not lost when the file is replaced. 

Macro Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




REPLACE 


addr, pfn, un, pwd, ucw, pn, r, fo 



addr 
pfn 
un 
pwd 

ucw 

pn 
r 

fo 



Address of the FET; local file name must be set in 
FET+0. 

Address containing the name of the permanent file to be 
replaced in the permanent file catalog. 

Address containing the name of the alternate user's catalog 
where the file resides. 

Address containing the password of the file being replaced 
(required if un j^ 0); if no previous file existed, the pass- 
word is saved with the file. 

Address containing user control word to place with the file; 
bit 59 of FET+11 must be set to retain the word with the 
file in the catalog. 

Address containing one- to seven-character pack name of 
the auxiliary device on which the file is to be placed. 

Type of auxiliary device identified by the pn parameter (refer 
to the DEFINE macro). 

Family option: 

IP The pack name specified by a PACKNAM macro 

or pn param.eter is ignored. PFM accesses the 
user's fam.ily. 

DF The pack name specified by a PACKNAM macro 
or pn parameter and the family name specified 
on the USER statement are ignored, PFM 
accesses the system default family. This option 
can be used only by programs that have an SSJ= 
entry point. 
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APPEND (007, CCAP) 

The APPEND macro enables a user to write the contents of the specified local mass storage 
files at the end of the specified indirect access permanent file. The logical structure of the 
two files is retained; that is, EORs and EOFs are appended as well as data. If the working 
file is appended to a file in an alternate user's catalog, a password must be supplied if one 
is required. 

Macro Format: 



LOCATION 



OPERATION 



APPEND 



VARIABLE SUBFIELDS 



addr, pfn, un, pwd, pn, r, fo 



addr 
pfn 

un 
pwd 

pn 

r 
fo 



Address of the FET; name of the local file to be appended 
must be set in FET+0. 

Address containing the name of the permanent file to which 
information is to be appended. 

Address containing the name of the alternate user whose 
catalog contains the permanent file . 

Address containing the password of the file to which infor- 
mation is to be appended. This must be specified if un / 
and the file requires a password. 

Address containing one- to seven- character pack name of the 
auxiliary device on which the specified permanent file resides. 

Type of auxiliary device identified by the pn parameter. 
Family option: 

IP The pack name specified by a PACKNAM macro 

or pn parameter is ignored. PFM accesses the 
user's family. 

DF The pack name specified by a PACKNAM macro 

or pn parameter and the family name specified 
on the USER statement are ignored. PFM 
accesses the system default family. This 
option can be used only by programs that 
have an SSJ= entry point. 
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An example of the use of this macro is: 
APPEND F 



F 



FILEB 



BUF, BUFL, (PFN=DATA)t 



The following diagram illustrates the structure of file DATA after the APPEND macro 
is issued. 



File F 



Data B 



EOR 



Data C 



EOR 



EOF 



EOI 



File DATA 



Resulting File (DATA) 



Data A 



EOR 



EOF 



EOI 



Data A 



EOR 



EOF 



Data B 



EOR 



Data C 



EOR 



EOF 



EOI 



Old File 
DATA 



Old File F 



DEFINE (010, CCDF) 

The DEFINE macro enables the user to specify a file as a direct access permanent file. 
The file specified must be a local file that resides on a permanent file device. If the file 
does not exist, a zero-length file is created either on the master device (refer to Mass 
Storage File Residence, section 2, volume 1, for a description of the master device), 
another device if the master device cannot be used, or that device specified by the r and/or 
pn parameters. 



tThe permanent file name can be set by FET creation macros as well as being set in the 
permanent file macros. 
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ATTACH (Oil, CCAT) 

The ATTACH macro enables the user to attach the specified direct access file to his 
control point. 

A read /write interlock is provided to ensure that only one user at a time accesses the 
file in write mode. Several users may access the file in read mode simultaneously. 
The user should return the file as soon as possible to enable other users to access the 
file. If a local file by the same name already exists, it is returned as if the UNLOAD 
macro had been issued even if the ATTACH is unsuccessful. 

Macro Format: 



lOCATION 



addr 
pfn 



un 



pwd 



m 



pn 



OPERATION 



ATTACH 



VARIABLE SUBFIELDS 



addr, pfn, un, pwd, m, pn, r, fo, fa, rt 



Address of the FET. FET+0 must contain the local file 
name of the file while attached to the job. 

Address containing the name of the file in the permanent 
file catalog. If pfn=0, the contents of FET+0 is used for 
the permanent file name. 

Address containing name of the alternate user catalog on 
which the file resides. 

Address containing file password; entered only if un^O and 
the file requires a password. 

Mode of access desired: 

m Description 

W Read, write* purge, and/or execute (default value). 

R Read and/or execute. 

A Append, read, and/or execute. 

E Execute. 

N None. 

M Modify, append, read, and/or execute. 

RM Read and/or execute, allow modifications. 

RA Read and/or execute, allow extensions. 

Refer to PFM Macro Parameter Conventions in this section for 
further information. 

Address containing one- to seven- character pack name of the 
auxiliary device on which the specified permanent file resides 
(refer to the DEFINE macro). 

Type of auxiliary device identified by the pn parameter (refer 
to the DEFINE macro). 
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fo Family option: 

IP The pack name specified by a PACKNAM macro or 

pn parameter is ignored. PFM accesses the user's 
family. 

DF The pack name specified by a PACKNAM macro or 

pn parameter and the family name specified on the 
USER statement are ignored. PFM accesses the 
system default family. This option can be used only 
by programs that have an SSJ= entry point. 

fa If this parameter is specified (any value may be used), the file 

being attached must be a fast attach permanent file. 

rt Real-time mode. If this parameter is specified (any value may be 

used), the job step is not delayed for either of the following condi- 
tions: 

• The file must be staged to disk from MSF. 

• A permanent file utility is currently active, preventing 
the ATTACH processing. 

If neither of these conditions exists, the rt parameter has no mean- 
ing. If one of these conditions exists and the rt parameter is not 
specified, the job step is delayed until the operation is complete. 
If one of these conditions exists and the rt parameter is specified, 
the file is not attached; instead the operation to ensure that the file 
resides on disk is initiated. To complete the attach, another 
ATTACH macro with or without the rt parameter should be issued 
and the FET status checked to ensure that the file was accessed. 
The function of the rt parameter is also accomplished by setting 
either the up or rt bit in the FET. 

If the user issues an ATTACH macro and the file is busy, the system aborts the request. 
The user can bypass the abort by specifying error processing (FET+1, bit 44). If ep is 
set and the file is busy, the system returns control to the user. He may then suspend his 
job by issuing the ROLLOUT macro. Normally, when a user issues a ROLLOUT macro to 
roll out his job subject to time /event dependencies, he must include an address specifying 
the time period and/or event. However, whenever file busy status is returned, PFM sets 
up a time/event entry for the user, specifying a default rollout time period of 360g seconds. 

Refer to the ATTACH control statement for a description of the resulting current access 
modes when the user attempts to attach an active file. 



CHANGE (012, CCCG) 

The CHANGE macro allows the originator of a direct or indirect access file to alter 
any of several parameters without having to attach and redefine the file or retrieve and 
save it. The ct and m parameters should be specified only if a change in the value 
associated with the parameter is desired. The pn and r parameters cannot be used to 
specify a new auxiliary device. They are used only to specify the auxiliary device on 
which ofn resides. 
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CONTROL POINT MANAGER 



Control point manager (CPM) enables the user to alter or interrogate parameters in the 

job control point area which controls the user's job in the system. All CPM functions must | 

be issued with auto recall specified. If it is not, the following message is issued. 

CPM-ILLEGAL REQUEST. 

All errors encountered by CPM cause the job step to be aborted; no user error processing 
is available. Unless otherwise noted, the following message is issued upon abnormal job 
termination. 

CPM-ARGUMENT ERROR. 
The format of the call to CPM is: 



59 



40 



35 



23 



17 



RA + I 



CPM 



iM 



code 



param 



r Auto recall bit (must be set) 

code CPM function code 

param Parameter for the function 

Common decks required for absolute assemblies by the functions processed by CPM 
are COMCCPM and COMCSYS. For relocatable assemblies, ' these decks are satisfied 
by default from the library SYSLIB. 

SETQP (000) 

The SETQP macro alters the queue priority of a job. The queue priority controls the 
scheduling of the job to and from the rollout queue. Lowering the queue priority may 
cause the job to be rolled out more often. 

Macro Format: f 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




SETQP 


n 



Queue priority; lOOo <n< current priority; (lOOs <n< 776I3 for 
a system origin job). If n is greater than 7761, the priority is 
set to 7761. If n=0 is specified, the queue priority is set to the 
rollout upper bound for the current job origin. 



t This macro is not available in SYSTEXT. The user must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix A). 
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SETPR (001) 

The SETPR macro alters the CPU priority of a job. The CPU priority controls the assign- 
ment of the CPU to active jobs. If the CPU priority is lower than that of other jobs, the 
job is assigned to the CPU only when jobs of a higher priority do not need it. Each job 
origin is assigned an initial CPU priority at system initialization. The user cannot exceed 
this priority. If he requests a priority that exceeds this value or IOq (maximum CPU 
priority), the maximum for the current job origin is used. 

Macro Format:! 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




SETPR 


n 



CPU priority; (l<n^ TOg); if n exceeds that for the current job 
origin, it is reduced to that value. 



MODE (002) 



The MODE macro defines the error conditions that cause the system to exit from normal 
processing. When the error the user specified occurs, the system sets the appropriate 
error flag and exits from normal processing to perform, any error processing required. 
If an error occurs for which the user did not select the exit mode processing, the system 
ignores the error and continues normal processing. 

Macro format:! 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




MODE 


m, n 



m 
n 



CPU program error exit mode. 

This parameter is included for compatibility with earlier 
versions of NOS. The value supplied is ignored. 



The processor will exit when 
this condition occurs 

Address out of range (automatically 
selected for CYBER 170 Model 176) 

Operand out of range (overflow only 
on model 176) 

Indefinite operand 

Underflow (model 176 only) 



If m has one of these octal values. 

1, 3, 5, 7 

2, 3, 6, 7, 12, 13, 16, 17 

4, 5, 6, 7, 14, 15, 16, 17 

10, 11, 12, 13, 14, 15, 16, 17 



The maximum value and default on all models except the CYBER 170 Model 176 is 7, indi- 
cating that the processor exits on all conditions. The maximum value on model 176 is I73 
indicating that the processor exists on all conditions. The default value on model 176 is 7, 
indicating that the processor exits on all conditions except underflow. 



tThis macro is not available in SYSTEXT. The user must specify systems text PSSTEXT 
or call common deck COMCCMD or COMCMAC (refer to appendix A). 



2-6-2 



60445300 M 



Examples: 

Setting m to 6 on all models other than a model 176 selects error exiting on operand out of 
range and indefinite operand. On a model 176, address out of range cannot be deselected; 
it is automatically set by the system. Setting m to 6 or 7 on a model 176 would yield the 
same results. 

Setting m to ISs on a model 176 selects error exiting on operand out of range, and underflow. 
Setting m to I23 would accomplish this also (because address out of range is automatically 
selected). 

SETASL (003) 

The SETASL macro allows the user to specify the account block SRU limit for a job. The 
account block limit is the maximum number of SRUs that can be accumulated by a job. 
If this limit is reached, the following message is issued. 

ACCOUNT BLOCK LIMIT. 

Each user and each charge /project number is validated for a maximum SRU limit. If the 
limit is exceeded or an account block less than 1 is specified, the message 

SL NOT VALIDATED. 

is issued. 
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EREXIT (004) 

NOS allows a user program to continue execution after an error occurs (except where 
prohibited), if the error return address is specified in the job control point area. When 
an error occurs, the system clears the error exit address and restarts the job at the CPU 
address specified. The contents of RA returned when an error is encountered is: 



59 


53 


47 


29 


23 


1 


5 





mo 


aaaaao 


ef 





ssw 






mo 



mo Bit 


EM Bit 


53 


59 


52 


58 


51 


57 


50 


50 


49 


49 


48 


48 



Mode of CPU error exit. For all computer systems except 
the CYBER 170, Model 176, the mode bit is set for the indi- 
cated EM register bit (refer to Exchange Package Area, 
appendix E). 

Meaning 

CM data error, t 

CMC input error, t 

ECS flag register operation parity 
error. t 

Indefinite operand. 

Operand out of range. 

Address out of range. 

If an mo bit is not set, the error is due to an illegal instruc- 
tion. 

For the CYBER 170, Model 176, the following mode bits are 
set for the indicated PSD register bit (refer to Exchange 
Package Area, appendix E). 

Meaning 

CM error condition. 

Not used. 

Not used. 

Indefinite condition. 

Overflow condition. 

LOME block range condition. 

CM block range condition. 

LCME direct range condition. 

CM direct range condition. 

Program range condition. 

The LCME error condition (PSD bit 47) and step condition 
(PSD bit 39) are not mapped to mo. 



mo Bit 


PSD Bit 


53 


46 


52 


-- 


51 


-- 


50 


38 


49 


37 


48 


45 


48 


44 


48 


43 


48 


42 


48 


41 



tCYBER 170 Series, Models 171, 172, 173, 174, 175, 720, 730, 750, and 760 only. 
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aaaaaa 
ef 



CPU address of the job when the error occurred 
Error flag: 

Error Flag Mnemonict Description 

Arithmetic error, mo is the 



lOB 



IIB 



ARET 



2 


PSET 


3 


PPET 


4 


CPET 


5 


PCET 



TLET 



FLET 



TKET 



SRET 



12B 


FSET 


13B 


ODET 


14B 


SPET 


14B 


RRET 


15B 


OKET 


16B 


SSET 


17B 


ECET 


2 OB 


PEET 


21B 


SYET 


22B 


ORET 



mode of the error. Refer to 
appendix E. 

A program stop was encountered 
by the CPU. 

PP abort. A PP program re- 
quested that the job be aborted 
(CIO, PFM, and so on). 

CPU abort. The job issued an 
ABT request. 

PP call error. The job called 
a nonexistent or illegal system 
request. 

Time limit. Job is allowed an 
additional 1 to 10 seconds of 
CPU time for error proc- 
essing. 

File limit. User attempted to 
assign more active files to the 
job than are allowed by the vali- 
dation parameter. 

Track limit. The job requested 
mass storage space on a device 
with none available. 

SRU limit. Job is allowed an 
additional 10 SRUs to complete 
error exit processing. 

Forced error. 

The operator dropped the job. 

Special error flag. 

Job rerun. 

Operator killed job. 

Subsystem abort. 

ECS parity error. 

CPU or CM parity error, tt 

System abort. 

Override of error condition. 



ssw 



status of sense switches 



tin order to use the mnemonic in a COMPASS program, either systems text PPTEXT or 

NOSTEXT must be specified, 
tt Applicable to CYBER 170 Series only. 
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Errors greater than or equal to SPET are considered special by certain system routines, 
Examples of this are as follows. 

• The job advancement routine lAJ does not invoke buffer flushing when an error 
occurs that is SPET or greater, 

• Read and write tape error recovery is not terminated by an errorless than SPET. 

o CIO does not terminate a skip operation unless the error is SPET or greater. 

o Waiting for a tape to be mounted and waiting for track limit terminate only on 
operator drop (ODET) or an error of value SPET or greater. 

Macro Format: 



LOCATION 


OPERATION 


VARIABLE SU8FIELDS 




EREXIT 


addr 



addr 



Address for error exit return 
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As an example, the common procedure is for the program's preset routines to set the error 
exit processing. 



Routine to 
complete 
processing 
when an error 
is encountered 



ERR 



PRS 



SAl BO READ ERROR RETURN INFO 



ENDRUN 

SUBR 
EREXIT ERR 



TERMINATE PROGRAM 

PROGRAM PRESET ROUTINE 
SET ERROR EXIT ADDRESS 



EQ PRSX 



END 
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ROLLOUT (006) 

The ROLLOUT macro places a job in the rollout queue until a specified event occurs or for 
a fixed period of time. This function may be useful if a program requires a direct access 
permanent file that is currently busy. 

Macro Formattt 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




ROLLOUT 


addr 



addr 



Address containing the time and/or event dependencies; 
if addr is not specified, the job is rolled out without time 
or event dependencies. 



The format of addr is: 



addr 



59 


29 


II 


° 


evd 


rtp 



evd 



Event descriptor. System programs use the EESET macrot t 
to make entries in a system event table indicating the 
occurrence of an event. The job scheduler compares the 
specified descriptor, evd, with events recorded in the table. 
If a match is detected, the scheduler initiates rollin. 



evd 5^0 



evd = 



evd=7700xxj 



evd and rtp are placed in the control point 
area (TERW). When the job rolls out, the 
scheduler waits for the occurrence of evd 
or for the time period, rtp, to elapse be- 
fore initiating rollin. Because the job may 
roll in for two different reasons, it is the 
user's responsibility to verify whether the 
specified event actually occurred. 

The job scheduler uses the value of evd 
already in the control point area. This 
option allows the user to roll out while 
waiting for a system-specified event. 

Specifies extended time rollout with no 
event dependency. The job rolls out for 
7777j,*xx+rtpn seconds. 



•j- This macro is not available in SYSTEXT, The user must specify systems text PSSTEXT 
or call common deck COMCMAC (refer to appendix A), 
•j-j- Use the DOCMENT control statement to obtain internal documentation of the EESET 
macro and the ROLLOUT macro for a description of valid event descriptors. 
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rtp 



Rollout time period in job scheduler delay intervals (roughly 
1 second each) where < rtp ^4095 (<7777g). 

If rtp is zero the scheduler uses the value of rtp already in 
the control point area. If evd is also zero the job rolls out 
waiting for a system specified event. If the event goes 
undetected or never occurs the job rolls in after a system- 
determined time interval. 



SETSSM (010) 

The SETSSM macro enables the user to set or clear the secure system memory (SSM) 
flag. Setting this flag prevents the dumping of any portion of the job field length. 
This flag is automatically set for programs containing an SSJ= or SSM= entry point 
(refer to appendix F)o If a request is made to clear SSM status by an SSM= program, 
the job step is aborted and the following message is issued. 

CPM-ILLEGAL REQUEST. 



NOTE 



While the SSM flag is set, no programs with a 
DMP= special entry point (refer to appendix F) 
can be called to the control point (refer to 
Security Considerations, section 2) unless the 
calling program contains an SSJ= entry point. 



Macro Format: t 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




SETSSM 


P 



Clear SSM flag if lower 12 bits of p are zero; set SSM flag 
if lower 12 bits of p are nonzero. 



f This macro is not available in SYSTEXT. The user must specify systems text PSSTEXT 
or call common deck COMCMAC (refer to appendix A). 
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ONSW (Oil) 



The ONSW macro sets the sense switches for a program (refer to figure 2-E-l). 
allows the user to set switches for options for subsequent tasks in the job. 



This 



The sense switches reside both in the user's control point area and in bits 11 through 
6 of RA+0 of the job field length. These two fields are maintained separately. The 
only transfer of information occurs at the start of each job step and when an error flag 
is detected. At these times the control point area field is copied into RA+0. The field 
in RA+0 is used when the user reads sense switch settings. An ONSW (or OFFSW) 
request updates both fields separately. 

The bit position specifies the switch to be set. 

Macro Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




ONSW 


n 



Switches to be set; 0<n<77g; bit corresponds to switch 1, 
bit 1 corresponds to switch 2, etc. If a bit is set, the 
corresponding switch is set; for example, ONSW 523 sets 
switches 2, 4, and 6. If n = 778, all switches are set. If 
n=0, all switches remain unchanged. 



OFFSW (012) 

The OFFSW macro enables the user to clear the sense switches for the job. Refer to the 
description of the ONSW macro for a discussion of sense switch settings. 

Macro Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




OFFSW 


n 



Switches to be cleared; 0<n<773; ^^^ ^ corresponds to switch 
1, bit 1 corresponds to s'wftch 2, etc. If a bit is set, the 
corresponding switch is cleared; for example, OFFSW 52g 
clears sense switches 2, 4, and 6. If n=778, all switches 
are cleared. If n=0, all switches remain unchanged. 



GETJN (013) 

The GETJN function allows the user to determine the system job name of the job. 
the format of the job name, refer to section 3, volunne 1. 



For 
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Macro Format:! 



LOCATION 


OPERATION 


VARIABIE SUBFIELDS 




GETJN 


addr 



addr 



Address to receive job name, left-justified 



addr 



59 


17 


job name 






GETQP (014) 

The GETQP function allows the user to determine the queue priority of the current job. 
Macro Formatrt 



LOCATION 


OPERATION 


VARIABLE SUBFIEIDS 




GETQP 


addr 



addr 



59 



Address to receive queue priority 

II 



addr 



qp 



qp Job queue priority 

GETPR (015) 

This function allows the user to determine the CPU priority of the current job. 
Macro Formatrt 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




GETPR 


addr 



59 



addr ^ Address where the CPU priority is returned 

11 



addr 



pr 



pr CPU priority 



tThis macro is not available in SYSTEXT. The user must specify systems text PSSTEXT 
or call common deck COMCMAC (refer to appendix A). 
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GETEM (016) 

The GETEM macro enables the user to determine under what exit mode control the job 
is currently running. 

Macro Format: t 



LOCATION 


OPERATJON 


VARIABLE SUBFIELDS 




GETEM 


addr 



addr 



Address for return of current exit mode in bits 11 through Q 



GETASL (017) 

The GETASL macro returns the account block SRU limit for the job (refer to SETASL 
macro) to the specified address. 



addr 



59 


17 





3 



Macro Format: t 



Account block SRU limit 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




GETASL 


addr 



addr 



Address to receive account block SRU limit 



f This macro is not available in SYSTEXT. The user must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix A). 
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GETJSL (017) 

The GETJSL macro returns the job step SRU limit for the current job step (refer to 
SETJSL macro) to the specified address. 



addr 



59 


17 





s 



Macro Format: t 



Job step SRU limit 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




GETJSL 


addr 



addr 



Address to receive job step SRU limit 



GETTL (017) 

The GETTL macro returns the time limit for the current job step. 



Macro Format:! 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




GETTL 


addr 



addr 



Address to receive time limit 



addr 



59 


17 





tl 



tl 



CPU job step time limit (in seconds) 



tThis macro is not available in SYSTEXT. The user must specify systems text PSSTEXT 
or call common deck COMCCMD or COMCMAC (refer to appendix A). 
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SETLC (022 ) 



The SETLC macro enables the user to set the loader control word for subsequent loader 
requests. The format of the loader control word is: 



59 57 53 



addr 



V '^mc 



V 

mc 



23 



17 



Map validation bit. If bit is not set, default map option is used. 

Map control bits (octal): 

00 No map is produced 

01 Statistics and errors 

02 Block assignments 

03 Partial map providing statistics, errors, and 
block assignments 

04 Entry points 

14 External references and entry points 

17 Full map providing information given individually 

by control bits 01, 02, 03, and 14 

Prevent field length reduction after relocatable load. 

Global library set indicators. 

The global library set indicators, contained in the loader 
control word (location LBIW in the user's control point area), 
are maintained by the SETLC macro. The user should call 
the GETLC macro before using the SETLC macro to avoid 
destroying the library set information. With the GETLC macro, 
the user can obtain the current loader control word and include 
bits 23 through in the control word used by SETLC. 



Macro Format :t 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




SETLC 


addr 



addr 



Address of the loader control word to be set 



tThis macro is not available in SYSTEXT. The user must specify systems text PSSTEXT 
or call common deck COMCMAC (refer to appendix A). 
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SETRFL (023) 

The SETRFL macro sets the initial central memory and ECS field lengths for a job step. 
The specified values are used unless the system encounters one of the following: 

• A system routine whose field lengths are specified during system creation. 

• A routine that specifies the amount of CM or ECS field length required in a 54 
loader table (refer to CYBER Loader Reference Manual). 

• An MFL or RFL control statement (refer to section 6, volume 1) or a subsequent 
SETMFL or SETRFL macro. 

If the user does not issue the SETRFL function or the RFL control statement, the operating 
system determines how much field length to assign initially for each job step. If the user 
I attempts to set the CM field length above that for which the user is validated, the following 
message is issued. 

CM NOT VALIDATED. 

If the user attempts to set the ECS field length above that for which the user is validated, 
the following message is issued. 

EC NOT VALIDATED. 



The CM field length is rounded upward to a multiple of lOOg words, 
length is in IOOO3 word blocks. 

Macro Format :t 



The ECS field 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




SETRFL 


n, m 



n 
m 



New CM field length restoration parameter 
New ECS field length restoration parameter 



GETJCR (024)^^ 



The GETJCR macro enables the user to interrogate the job control registers associated 
with his job (refer to the description of the system control language, section 4, volume 1). 
The last error flag encountered can also be determined. Information is returned in the 
following format. 



addr 



59 


53 




35 




17 







pef 


R3 


R2 


Rl 



t This macro is not available in SYSTEXT. The user must specify systems text PSSTEXT 

or call common deck COMCCMD (refer to appendix A), 
tt The user should use the GETJCI macro instead of GETJCR. 
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pef 

R3 
R2 
Rl 



The last error flag encountered (refer to the EREXIT function 
for the values) 

Job control register 3 

Job control register 2 

Job control register 1 



Macro Format:! 



LOCATION 


OPERATION 


VARIABLE SUBFIEIDS 




GETJCR 


addr 



addr 



Address for return of the job control registers 



SETJCR (025)tt 

The SETJCR macro enables the user to set the job control registers for the job. 
to the description of the GETJCR macro for the format of the word. 



Refer 



Macro Formatrt 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




SETJCR 


addr 



addr 



Address of the word containing the job control registers to 
be set 



addr 



59 


53 




35 




17 





pef 


R3 


R2 


Rl 



pef 
R3 
R2 
Rl 



Previous error flag 
Job control register 3 
Job control register 2 
Job control register 1 



t This macro is not available in SYSTEXT. The user must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix A), 
tt The user should use the SETJCI macro instead of SETJCR. 
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SETSS (026) 

The SETSS macro specifies the subsystem under which the job is currently executing, 
provided the user is validated for that subsystem, if not, then the operation is aborted 
and the following error message is issued. 

CPM-ILLEGAL USER ACCESS. 
Macro Format:! 



lOCATION 


OPERATION 


VARIABIE SUBFIEIDS 




SETSS 


ss 



ss 



Subsystem ordinal (refer to the TSTATUS macro, section 
12, for a description of subsystem ordinals) 



GETJO (027) 

This function reads the job origin code from the user's control point area and returns 
the code right-justified at the address specified by the user. 

Macro Format:! 



LOCATION 


OPERATION 


VARIABLE SUBFIEIDS 




GETJO 


addr 



addr 



Address to receive job origin code. Refer to appendix E 
for legal job origin codes. 



59 



addr 



io 



30 



Job origin code 



GETJA (030) 

This function transfers the job accounting information to the address specified by the user, 
The data is returned in the following form. 



t This macro is not available in SYSTEXT. The user must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix A). 
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59 



41 39 



19 



addr + 
+ 1 
+ 2 
+ 3 






SRU accumulator (micro units ^10) 


CP accumulator (quarter nanounlts) 


MS accumulator 


MT accumulator 


PF accumulator 





adder accumulator 



Macro Formatrt 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




GETJA 


addr 



addr 



Address to receive job accounting data 



Nanounits are calculated as nanoseconds multiplied by the CPU accounting multiplier (refer 
to Resource Accounting in section 5 of the NOS System Maintenance Reference Manual). 



USECPU (031) 

The USECPU macro specifies which central processor is to be used when more than 
one is available. 

Macro Format: 



LOCATION 



OPERATION 



VARIABLE SUBFIELDS 



n=0 
n=l 

n=2 



USECPU 



Either central processor can be used 

CPU is to be used (the CPU with functional units on a 
6700 or CDC CYBER 74-2x) 

CPU 1 is to be used (the CPU without functional units on a 
6700 or CDC CYBER 74-2x) 



USERNUM (032) 

The USERNUM macro returns the user number the job is running under to the specified 
address. 



tThis macro is not available in SYSTEXT. The user must specify systems text PSSTEXT 
or call common deck COMCMAC (refer to appendix A). 
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Macro Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIEIDS 




USERNUM 


addr 



addr 



Address to receive the user number, left-justified and 
zero-filled 



GETFLC (033, 055) 

The GETFLC macro returns the field length control word from the user's control point 
area to the specified address. 

Macro Format: t 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




GETFLC 


c addr .eaddr 



caddr 



Address to recoive the central memory field length control 
word 



eaddr 



Address to receive the ECS field length control word 



The GETFLC request can Include either or both of the addresses. The field length control 
words are returned in the following format (multiply each 12 -bit field by lOOg for caddr or 
IOOO3 for eaddr to obtain the actual value). 



coddr 

and 

eoddr 


59 




47 




35 




23 




1 


mfl 


rfl 


jmfl 


rifl 


fllr 



mfl 



rfl 



Maximum CM or ECS field length for the current job step. 
This value may be reset with the MFL control statement 
(refer to section 6, volume 1) or SETMFL macro. 

Initial running CM or ECS field length for a job step. This 
value is always less than or equal to mfl and is set with the 
RFL control statement or SETRFL macro. A value of 
indicates that the system controls the field length. 



t This macro is not available in SYSTEXT. The user must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix A). 



2-6-20 



60445300 M 



The subsystem ordinal is returned in the following format. 
59 



addr 



ss 



2 



Subsystem ordinal 



VERSION (044) 

The VERSION macro returns the version name of the operating system from central 
memory to a location specified by the user. Location addr contains parameters speci- 
fying the disposition of the version name. 



59 



47 



35 



23 



17 



^ 



addr 



be 



sb 



bp 



waddr 



be 
sb 
bp 
waddr 



Number of bytes (1 to 10) to return from two- word source 
field (CM location containing version name) 

Byte in source field to begin transfer at (0 to 9); the sum of 
be and sb must be less than 11 

Byte position within receiving field (waddr) to begin trans- 
fer at (0 to 4) 

Beginning address of three-word block to receive data 



Macro Format: t 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




VERSION 


addr 



addr 



Address of word containing macro parameters 



GETLC (045) 

The GETLC macro enables the user to determine the loader control word, 
the SETLC macro for the format of the loader control word. 



Refer to 



Macro Format:! 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




GETLC 


addr 



addr 



Address to receive the loader control word 



-f- This macro is not available in SYSTEXT. The user must specify systems text 
PSSTEXT or call common deck COMCCMD or COMCMAC (refer to appendix A). 
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GETGLS (046) 

The GETGLS macro returns the global library set from the user's control point area. 
Refer to the CDC CYBER Loader Reference Manual for a discussion of global library 
sets. A parameter word is used to specify where a list of logical file names is to be 
placed. 

Macro Format:! 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




GETGLS 


addr 



addr 



Address of parameter word 



Parameter word format: 

59 53 

addr 



35 






list 





e 



list 



Beginning address to which the logical file names (left- 
justified) contained in the global library set are written. 
The value of this paranieter is updated to the address of 
the last library (llst+n) upon completion. 

Completion bit. 



Upon return from the GETGLS macro, locations list through list+n are updated as 
follows: 



59 



list + 
+ 1 
+ 2 



llst+n 



Ifn of, first library 



Ifn of second library 



Ifn of third library 



Ifn of last library 



17 




Ifn 



The number of libraries minus one defined in the global 
library set. 

The name of a global local library or the name of a system 
library. 



tThis macro is not available in SYSTEXT, The user must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix A). 
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SETGLS (047) 

The SETGLS macro enables the user to define the global library set indicators in the user's 
control point area. Refer to the CYBER Loader Reference Manual for a discussion of 
global library sets. A parameter word specifies where the list of logical file names used 
to define the global library set is located. 

Macro Format: t 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




SETGLS 


addr 



addr 



Address of parameter word 



Refer to the GETGLS macro for the format of the parameter word. 

Before calling the SETGLS macro, locations list through list+n+1 must be as follows: 

59 17 



list +0 


Ifn of first library 


w////////m. 




+ 1 


Ifn of second library 


w////////m 




+ 2 


Ifn of third library 


W////////M 




• 
• 


• 
o 




-» 


list+n 


Ifn of last library 


W////////M 












n The number of libraries minus one in the global library 

set. 

Ifn The name of a global local library or the name of a system I 

library. I 



tThis macro is not available in SYSTEXT. The user must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix A). 



60445300 M 



2-6-25 



MACHID (050) 



The MACHID macro enables the user to determine the one- or two-character machine 
identification th^at is established at deadstart time. 

Macro Format: t 



LOCATION 



OPERATION 



MACHID 



VARIABLE SUBFIELDS 



addr 



addr 



Address to receive machine identification 



The machine identification is returned in the following format. 

59, II 



addr 



id 



GETACT (051) 

The GETACT macro allows the user to obtain information regarding outstanding system 
activity for a job. 

Macro Format: t 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




GETACT 


addr 



addr Address to receive information 

The system activity information is returned in the following format. 



59 



47 



23 



addr 



sea 


e 


raitrvid 


reserved for 
Installation 


reserved 


c 



sea 



Count of system completable activities 

Long-term activity pending 

Completion bit (set to one when operation is complete) 



tThis macro is not available in SYSTEXT. The user must specify systems text 
PSSTEXT or call common deck COMCCMD (refer to appendix A). 
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The sea field is incremented by one for each of the following; 



• Each PP activity outstanding. This includes any PP routines called without auto 
recall that have not yet completed (for example, CIO). This count does not 
include the CPM function returning this information. 



NOTE 



This function does not count PPs that have moved 
to another control point at the time the GETACT 
request is being processed and then move back to 
the original control point. 

• Each PP routine that has placed itself in PP recall and has not yet completed. 

• Each tape I/O activity outstanding. Although these are initiated through CIO 
requests, they are handled separately by the system and are counted here and 
not with the PP activity. 

• The rollout flag is set in the control point area. 

• An interactive I/O request that has been made but not yet processed. 

If C (bit 47) is equal to 1, a long-term activity is pending. Such an activity either requires 
termination by the user or operator intervention. The following are long-term activities. 

• K or L console display interface. 

• CFO entry enabled (refer to NOS Operator's Guide for a description of CFO 
entries). 

• A system control point (SCP) long-term connection. 



SETMFL (052) 

The SETMFL macro enables the user to change the job step maximum field length (MFL) 
boundary (refer to GETFLC and SETRFL macros for discussion of maximum field length 
limit). If either parameter is 0, the maximum field length is set to the maximum allowable 
field length for the user. 
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Macro Format 



•t 



lOCATION 


OPERATION 


VARIABLE SUBFIELDS 




SETMFL 


n, m 



m 



New maximum central memory field length limit for 
job step 

New maximum ECS FL/lOOOg limit for job step 



GETPFP (057) 

I The GETPFP macro returns a job's permanent file parameters (current family name, 
pack name, user number, and user index). 

Macro Format: t 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




GETPFP 


addr 



addr 



Address to receive three-word table containing permanent 
file parameters 



The current permanent file parameters are returned in the following format. 





59 




17 







addr +0 


family name 





+ 1 


pack name 





+ 2 


user number 


user index 



"f This macro is not available in SYSTEXT. The user must specify systems text 
PSSTEXT or call common deck COMCCMD or COMCMAC (refer to appendix A). 
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GETLOF (061) 

The GETLOF macro returns the address of the list of files from the user's control 
point area to the specified address. The address of the list of files is set in the 
control point area with the SETLOF macro. 

Macro Format: t 



LOCATION 


OPERATION 


VARIABLE SUBFIEIDS 




GETLOF 


addr 



addr Address to receive the list of files pointer 

Upon return from the GETLOF macro, location addr has the following format. 



59 



47 



29 



addr 






pointer 


|c 



pointer Address of list of files table established with the 

SETLOF macro 

c Completion bit 



If the system returns in the pointer field, no list of files address has been previously set 
(refer to description of SETLOF macro). 



I This macro is not available in SYSTEXT. The user must specify systems text 
PSSTEXT or call common deck COMCCMD (refer to appendix A). 
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SETLOF (062) 

The SETLOF macro enables the user to specify a pointer to a list of files whose 
circular buffers will be flushed at job step abort or for terminal files, when the job 
is rolled out. 

Macro Format :t 



lOCATION 


OPERATION 


VARIABLE SUBFIEIDS 




SETLOF 


addr 



addr Address containing the pointer to the list of files table 

The format of location addr before issuing the SETLOF macro must be as follows; 



oddr 



59 




47 




29 










pointer 


1 



pointer 



Address of list of files table 



The list of files table has the following format. 

59 17 

pointer +0 

+ 1 

+2 

+ len-2 
+ len-1 



m 





len 


Ifn^ 


fet^ 


Ifng 


fetg 


1 


1 


'^"n 


^•♦n 






m 

len 
Ifn. 
feti 



Common memory manager (CMM) block indicator; setting 
this bit indicates that the file list is CMM controlled 

Length of the list of files table including zero termination word 

File name 

FET address 



t This macro is not available in SYSTEXT. The user must specify systems text PSSTEXT 
or call common deck COMCCMD (refer to appendix A). 
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QUEUE FILE MANAGER 



Queue file manager (QFM) performs functions associated with queue and dayfile protection. 
The majority of the QFM functions are for special system jobs; these functions are not 
discussed in this manual (refer to the NOS Systems Programmer's Instant) since they are 
not available to the applications programmer. Functions available to the applications user 
include user requests to: 

• Allow a job to be rerun or not rerun in the event of a system interrupt, 

• Release a file from a job to either the remote or local batch input queues. 

• Assign a file to a queue device. 

All requests to QFM must be made with the auto recall bit set; if it is not, the job step is 
aborted and the following message is issued, 

QFM ILLEGAL REQUEST. 

If the parameter addresses are not within the user's field length, the job step is aborted 
and the following message is issued. 

QFM ARGUMENT ERROR. 
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The format of the call to QFM is: 



RA + I 



59 




40 35 




23 17 









QFM 


WA 


code 


m^ 


Qddr 





r 

code 

addr 



Auto recall bit 

Function code 

Address of the PET for the file 



The format of the PET used by QPM is: 

59 53 47 44 



23 



17 13 



FET + 


local file name (Ifn) 


^ 


at 


code 


+ 1 


W/////////.. 


e 
P 


W////////////////M 


FIRST 


+ 2 


i^^^m^^m^^^^^m^^^^^^^^^^m 


IN 


+ 3 


y///////////////M^^^^ 


OUT 


+ 4 


m^^^^^^M^m^^m^^^^^^:^^ 


LIMIT 


+ 5 


function parameter 


+ 6 


function parameter 


+ 7 


Wk 


eq 


y///////////////////^^^^^^ 


ms 


+ 8 


function parameter 



at 

code 
ep 
eq 

ms 



RERUN (015) 



Abnormal termination code 

Completion code 

Error processing bit 

Equipment number 

Mass storage error code (bits 11 through 0) 



The RERUN macro sets the job rerun status, indicating that the job may be rerun in 
the event of system failure. This macro need not be used unless queue protection was 
disabled by a previous NORERUN macro, since all jobs in the input queue are initially 
given rerun status. The RERUN macro has no effect if used from a tim.e- sharing 
origin job. 

Macro Format:! 



lOCATION 



OPERATION 



RERUN 



VARIABLE SUBFIEIDS 



tThis macro is not available in SYSTEXT. The user must specify systems text PSSTEXT 

or call common deck COMCMAC (refer to appendix A). 
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NORERUN (016) 

The NORERUN macro clears the job rerun status (initially enabled) and prevents a job 
from being rerun as the result of queue protection. With this macro the user can 
specify when a job may be safely rerun. For example, if a job has just updated a 
critical data base, it is probably desirable not to rerun the job. Hence, the user can 
use the NORERUN macro to prevent thiSo This macro affects input files only. The 
NORERUN macro has no effect if used from a time-sharing origin job. 

Macro Format: t 



LOCATION 



OPERATION 



VARIABLE SUBFIELDS 



NORERUN 



SUBMIT (017) 



NOTE 



This macro will not be available in future releases 
of NOS. If possible, the user should use instead the 
ROUTE macro described in section 8. 

The SUBMIT macro enables the user to release a file from a job to either the remote 
or local batch input queues. The user must be validated to use this function (refer to 
the DB field of validation limits in section 6, volume 1), but does not need system 
origin privileges. This file must have the normal job file format. If the user wishes 
to reformat a file before submitting it for processing, he should use the SUBMIT con- 
trol statement (refer to section 6, volume 1). 

If a submitted job contains an illegal first USER statement, the job entering the SUBMIT 
function is aborted via a system error (no exit processing) and the following messages are 
issued to the user dayfile, 

ILLEGAL USER CARD. 
SYSTEM ABORT. 

The following message is issued to the account dajrfile. 

SIUN.usernum. 

Terminal users are immediately logged off without receiving a dayfile message and without 
recovery. 



t This macro is not available in SYSTEXT. The user must specify systems text PSSTEXT 
or call common deck COMCMAC (refer to appendix A). 
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The occurrence of an illegal user statement also decrements the security count for the 
user number of the job that initiated the SUBMIT function. The security count is the 
number of security violations a user number has remaining before It is denied access 
to the system. If a user number's security count Is exhausted, the following message 
Is Issued at job Initiation. 

ILLEGAL USER ACCESS - CONTACT SITE OPR. 

The security count for the user number must be reset before access to the system Is 
allowed for that user number. 



Entry condition: 



FET+6 



59 


23 


II 





Id 


ot 



id 
ot 



Identification code to be assigned to the job 

Origin type of the job to be submitted; must be local batch 
(BOOT, 1) or remote batch (EIOT, 2) 



The identification code is the same as that described for the SETID macro in section 4. 
However, if id is set to 77g in FET+6, ail job output is discarded at job termination. 

A FET buffer of at least one PRU must be provided to allow QFM to read first sector for 
job control statement translation, 

I The job name given to the deferred job is returned in bits 59 through 18 of FET+6. This 
job name is derived from the user number specified on the user statement of the submitting 
job. This is the same as the method used for time-sharing and remote batch origin jobs 
(refer to section 3, volume 1). 

This macro requires the common decks COMCQFM and COMCSYS. 
Macro Formatrf 



lOCATION 


OPERATION 


VARIABLE SUBFIEIDS 




SUBMIT 


addr 



addr 



Address of the FET that specifies the file to be submitted. 



t This macro is not available in SYSTEXT. The user must specify systems text PSSTEXT 
or call common deck COMCMAC (refer to appendix A). 
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ASSIGN FILE TO QUEUE DEVICE (020) 



NOTE 



This function will not be available in future releases 
of NOS. The user should use instead the REQUEST 
macro (LFM function 15o) described in section 4. 



Function 020 enables the user to assign a file to a queue device (a device to which queue 
type files are assigned). A queue file of the specified type is assigned to the mass 
storage device specified in the mass storage allocation (MSAL) entry. 

Entry condition: 



59 



FET + 5 



qt 



qt 



Queue type. 

Type 

INFT 
PR FT 
PHFT 



The qt field contains the queue -type value. 
Value 



No macro is available for this function, 
macro in the following manner. 



The user should call it with the SYSTEM 



SYSTEM QFM, R, addr, 2000B 

R Auto recall bit (must be set) 

addr Address of the FET 

2000B Function code (020) ='^ lOOg 

If the MSAL control is set (refer to the NOS Operator's Guide for a discussion of 
MSAL), the specified file is assigned to the device. Otherwise, no action is taken. 
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FILE ROUTING 



8 



DSP FUNCTION 

File routing under NOS is performed by the dispose processor (DSP). DSP is called by an 
RA + 1 call or the ROUTE macro. DSP places a file in an input or output queue of either the 
central site or a remote batch site. The function can be issued from jobs of any job origin 
type. 



NOTE 



If a file is routed to an input queue, it must 
contain a valid user statement or the job initi- 
ating the route will be aborted without exit proc- 
essing. Refer to the SUBMIT macro, section 7, 
for further information concerning illegal user 
statements. 



The format of the call to DSP is: 



59 



40 



35 



17 



RA+I 



DSP 



/r 



addr 



r 
addr 



Auto recall bit (must be set) 

First word address of parameter block 



The user must define a parameter block as described below before issuing the DSP call 
or ROUTE macro. 





59 




47 


35 




23 






17 




II 





addr +0 


Ifn 


ec 


W//M 


c 


+ 1 





forms 


disp 


ex 


/ 
/ 


ic 


flags 


+ 2 


reserved 


TID 


+ 3 


reserved 


priority 


+ 4 


spacing 


reserved 


abort code 


reserved 


/ 


re 


reserved 


+ 5 


reserved 


+ 6 


reserved 



Ifn 



ec 



Local file name of file to be routed (must be a print, 
punch, input, or local file; naust not reside on a removable 
device; and must have read permission). 

Error code returned by system when bit 12 of flags field is 
set (error codes described later in this section). 
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c Completion bit (must be zero when function is issued; system 

sets bit to one when operation complete). 

forms Forms code or input flags. Two display code characters or 

specific bits set identifying the forms to be used for this file 
or other processing options. If file is routed to input queue, 
this field is defined as follows: 

Bits Description 



47-46 Unused 

45 Do not protect input file 

44 Send file to output queue; forced abort 

43 Send file to input queue even if job statement 

error 
42-36 Reserved 

Forms codes are two alphanumeric characters and are as- 
signed by each installation. The user should contact in- 
stallation personnel to determine what forms codes are 
available (if any). 

disp Disposition code. Two alphanumeric characters specifying 

the disposition of the routed file. 

Code Description 



IN Release file to input queue 

LP Print on any line printer 

LR Print on 580-12 line printer 

LS Print on 580-16 line printer 

LT Print on 580-20 line printer 

NO Release file to input queue. Drop job output 

at job completion. 

PB Punch system binary 

PH Punch coded 

PI. Plotter 

PR Same as LP 

PU Same as PH 

P8 Punch 80 column binary 

SB Same as PB 

SC Rescind prior routing and change file type to 

local (LOFT) 

ex External characteristics (bits 23 through 21) code translated 

as follows: 

Value Print File Punch File 

(default) (default) 

1 Unused SB 

2 A4 80COL 

3 B4 Unused 

4 B6 026 

5 A 6 02 9 

6 A9 Unused 

7 Reserved Reserved 

The mnemonics in the above table are defined as follows; 

Mnemonic Description 

A4 ASCII graphic 48-character set (not supported; 

provided for NOS/BE compatibility) 

A6 ASCII graphic 64-character set 

A9 ASCII graphic 95-character set 
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Mnemonic Description 



B4 BCD 48-character set (not supported; provided 

for NOS/BE compatibility) 

B6 CDC graphic 64-cIiaracter set 

02 6 Punch 02 6 mode 

02 9 Punch 02 9 mode 

SB Punch system binary 

80COL Punch 80-column binary 

ic Internal characteristics (bits 19 through 18) code translated 

as follows: 

Value Description 

Display code 

1 ASCII code 

2 Binary 

3 Reserved 

flags Each bit set indicates that a parameter is specified. 

Bit Description 

17 File name assigned by system is returned 

to addr+0,bits 59 through 18 

16 Reserved 

15 580 PFC spacing code 

14 Repeat count 

13 Reserved 

12 No dayfile message and return error code to 

addr+0, bits 17 through 12 

11 Reserved 

10 Forms code 

9 Priority 

8 Internal characteristics 

7 External characteristics 

6 Reserved 

5 Reserved for installations | 

4 Disposition code 

3 Reserved 
2 TID 

1 Route to central site 

End-of-job (deferred ROUTE) 

The system determines the routing destination of an output 
file by flag bits 1 and 2 (route to central site and TID, 
respectively) as follows: 

Central TID 

Site Bit Bit Routing Activity 



If the calling job is remote batch origin, 
the system routes output to the remote 
batch queue and associates with it the 
user number and family of the originating 
remote batch terminal. If the calling job 
is any other origin type, the system routes 
output to the central site queue. If the file 
being routed was previously routed with 
queuing deferred, the previously specified 
destination remains in effect. 
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Central TID 

Site Bit Bit Routing Activity 

1 The system routes output according to the 

contents of the TID field (description 
follows). 

1 The system routes output to the central 

site queue. 

1 1 The system routes output to the central 

site queue if the TID field contains a valid 
ID code; otherwise, the system aborts the 
job. 

TID For routing to a remote batch queue, the TID should contain 

the complement of the address of a two-word block. The first 
word of the block contains the family name and the second word 
contains the user number (both left- justified and zero-filled). 
This is the user number that must be used to log in at a remote 
terminal to get the routed file. 

If the address specified by the TID field equals llllllll^,' ^^^ 
file is routed to the remote batch queue with the family and 
user number of the calling job. 

For routing to the local batch queue, the TID contains an ID 
code (right- justified). 

priority If job priority is greater than 7760 octal, the specified priorit;; 

is used for output files (otherwise field is ignored) 

spacing Spacing code for output files (580 PFC). Octal value from 

to 77. 

abort code If bit 44 of the DSP parameter word 1 is set, the value of this 

field determines which message from the following table is 
sent to the dayfile. 

Value Message 

0001 Job statement error 

0002 Card reader error 

0003 Operator input termination 

0004 Disk full 

0005 Disk parity error 

Any other value will cause the message 
DSP-INVALID JOB ABORT CODE, 
to be issued, 
re Repeat count 

ROUTE 

The format of the ROUTE macro is as follows: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




ROUTE 


addr, r 



addr Address of parameter block 

r Auto recall 
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Example 1: 

The following example routes a file named PRINTF for printing on any central site line printer. I 



PBLK 


VFD 


42/0LPRINTF,18/0 




VFD 


24/0, 12/2HLP, 6/0, 18/22B 




VFD 


60/0 




VFD 


60/0 




VFD 


60/0 




VFD 


60/0 




VFD 


60/0 




• 

ROUTE 


PBLK, R 



Example 2: 

The following example defers routing a file named PRINTF in ASCII graphic 95-character 
set and specifies that two copies be printed. 



PBLK 



VFD 


42/0LPRINTF,18/0 


VFD 


24/0, 12/2HLP. 3/6, 3/0, 18/40221B 


VFD 


60/0 


VFD 


60/0 


VFD 


42/0,6/1, 12/ 


VFD 


60/0 


VFD 


60/0 


ROUTE 


PBLK, R 
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Example 3: 

The following example routes a file named JOBl to the input queue for processing at the 
central site and writes the job name assigned by the system to the user dayfile. 



PBLK 



VFD 


42/OLJOBl, 18/0 


VFD 


12/0. 12/lOOOB, 12/2HIN, 6/0. 18/402022B 


VFD 


60/0 


VFD 


60/0 


VFD 


60/0 


VFD 


60/0 


VFD 


60/0 


ROUTE 


PBLK, R 


SAl 


PBLK 


MXO 


42 


BX6 


XO-Xl 


SA6 


Al 


MESSAGE 


PBLK, 3 



ERROR PROCESSING 

When an error occurs in processing a ROUTE macro or DSP call, either a dayfile message 
explaining the error is issued, or an error code is returned in bits 17 through 12 of addr+O. 
If the address of the parameter block is outside the field length of the job or if the completion 
bit is set when the function is issued, the job step aborts. For all other errors, the function 
is not executed, but error processing continues. If bit 12 of the flags field is set, an error 
code is returned and no dayfile message is issued. If bit 12 is not set, no error code is 
returned, a dayfile message is issued, and the job step aborts. 

When a diagnostic is issued for the ROUTE macro, the message 

ERROR IN ROUTE FUNCTION LFN = Ifn. 

is issued, followed by the message describing the error. 

The error codes that can be returned are as follows: 



Error Codes 

1 

2 

3 

4 

5 

6 

7 
10 
11 
12 
13 
14 
15 



Description 

File name error 

File not on mass storage 

Illegal file type 

Output file limit 

Route to input not immediate 

Immediate routing - no file 

Invalid disposition code 

Reserved 

Reserved 

Illegal request (unconditional abort) 

Reserved 

Reserved 

Reserved 
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Error Codes Description 

16 Cannot route job input file 

17 Completion bit already set (unconditional abort) 

20 File on removable device 

21 Invalid TID 

22 Forms code not alphanumeric 

23 Reserved 

24 Reserved 

25 Reserved 

26 This routing not allowed 
2 7 FNT /device full 

30 Local file limit 

31 I/O sequence error (unconditional abort) 

32 Job statement error 

33 Too many deferred batch jobs 

34 Illegal user statement (returned for jobs with priority 

greater than 7760g) 

35 Device unavailable 

36 Illegal file mode 

37 Invalid external characteristics 

40 Illegal origin type 

41 Invalid spacing code 

42 Invalid job abort code 

For a complete listing of error messages, refer to appendix B. 
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SYSTEM TIME/DATE REQUESTS 



NOS provides several system requests associated with the time and date. These requests 
are processed directly by CPUMTR. Unless otherwise noted, the only common deck re- 
quired for absolute assemblies is COMCSYS. 

The format of the RA + 1 call to the time function processor is: 



59 



40 



35 



23 



17 



RA+I 



TIM 



code 



oddr 



r 
code 



addr 



Auto recall bit. (Must be set.) 
Function code as follows: 



Code 

0000 
0001 
0002 
0003 
0005 
0006 

0007 
0011 

0012 



Macro 

TIME 

DATE 

CLOCK 

JDATE 

RTIME 

PDATE 

STIME 
HTIME 

HTIME 



Description 



Accumulated 
Current date 
Current time 
Current julia 
Elapsed real 
Current date 
binary form 
Accumulated 
Accumulated 
control point 
Accumulated 
deadstart 



CP time used by the job 
in display code 
of day in display code 
n date 

time since last deadstart 
and time in packed 

system resource units 
clock cycle count for 

clock cycle count since 



Address of a reserved one word block that will receive the 
reply. 



The EDATE and ETIME macros described in this section do not have an RA + 1 call. They 
are processed by common deck COMCEDT and are used to convert the format of a date 
and time returned by a previous macro call. 

CLOCK 

In response to the CLOCK function, the system returns the current time of day in display 
code in location addr. 



Macro Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




CLOCK 


addr 



addr Address to receive the clock reading 

59 53 41 35 23 17 

addr 



A 


hh 


. 


mm 


. 


ss 


• 
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DATE 



In response to the DATE function, the system returns the current date in display code 
format in location addr. 

Macro Format: 



lOCATION 


OPERATION 


VARIABLE SUBFIEIDS 




DATE 


addr 



addr Address to receive the date 

59 53 41 35 23 \7 



addr A 



yy 



/ 



/ 



dd 



5 



EDATE 

EDATE takes the packed date and converts it to display code. 

59 17 II 5 

pdate 






yy 


mm 


dd 



yy 


Year minus 1970 


mm 


Month 


dd 


Day 



Macro Formatt 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




EDATE 


pdate 



pdate Register or expression containing packed date to be converted, 

Upon completion, X6 contains the following: 

59 53 41 35 23 17 5 

(X6) 



A 


yy 


/ 


mm 


/ 


dd 


• 



This macro requires the common deck COMCEDT. 



tThis macro is not available in SYSTEXT. The user must specify systems text PSSTEXT 
or call common deck COMCMAC (refer to appendix A). 
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ETIME 

ETIME takes the packed time and converts it to display code. 

59 17 I I 

ptime 



immm^^^mmmm^ 


hh 


mm 


ss 



hh 


Hours 


mm 


Minutes 


ss 


Seconds 



Macro Format: t 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




ETIME 


ptime 



ptime Register or expression containing packed time to be converted, 

Upon completion, X6 contains the following: 

59 53 41 35 23 17 5 



(X6) A 



hh 



This macro requires the common deck COMCEDT. 



HTIME 

The HTIME macro returns the CYBER 170 Series, Model 176 accumulated CPU clock cycle 
count (if available) either for the user's job or since the last system deadstart. A clock 
cycle on the model 176 is 27. 5 nanoseconds. 

Macro Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




HTIME 


Stat, op 



addr 
op 



Address to receive accumulated CPU clock cycle count. 

Option desired: if 0, accumulated clock cycle count for the 
user's job is returned (function code 11); if 1, accumulated 
clock cycle count since the last system deadstart is returned 
(function code 12). 



tThis macro is not available in SYSTEXT. The user must specify systems text PSSTEXT 
or call common deck COMCMAC (refer to appendix A). 
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After the HTIME request is processed, location addr has the following format. 
59 47 



addr 



type 



CPU clock cycle count 



type 



If the model 176 CPU clock cycle count is available, type is 
2OOO3. If the model 176 CPU clock cycle count is not avail- 
able, type is 60003. 



JDATE 

JDATE returns the current Julian date in addr. 
Macro Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIEIDS 




JDATE 


addr 



addr 



Address which receives the Julian date 



59 



addr 



29 



17 






yy 


ddd 



yy 

ddd 



Julian year 
Julian day 



PDATE 

PDATE returns the current date and time in binary packed format. The user can unpack 
the parameters or use the EDATE and ETIME macros to do the unpacking. 

Macro Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




PDATE 


addr 



addr 
59 



addr 



Address to receive the packed date 
35 29 23 17 I 






yy 


mo 


dd 


hh 


mm 


ss 



yy 


Year minus 1970 


mo 


Month 


dd 


Day 


hh 


Hours 


mm 


Minutes 


ss 


Seconds 
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RTIME 

In response to the UTIME function, tlie system returns the real-time clock reading in 
location addr. This is the elapsed time since deadstart. 

Macro Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




RTIME 


addr 



addr 

59 
addr 



Address to receive the clock reading 



35 



seconds 


milliseconds 



STIME 

With the STIME macro, the user can determine his accumulated system resource units 
(SRU). Refer to the NOS System Maintenance Reference Manual for a description of SRUs, 

Macro Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




STIME 


addr 



addr 



Address to receive SRU value 



59 



addr 



35 






milllunits 



milliunits Accumulated system resource units/ 1000 



6 04453 00 M 
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TIME 

The TIME function returns the accumulated central processor time used by the job in 
location addr. 

Macro Format: 



lOCATION 


OPERATION 


VARIABLE SUBFIELDS 




TIME 


addr 



addr 



Address to receive the CPU time 





59 




47 




35 




1 


addr 


•2000 


0000 


seconds 


milliseconds 



milliseconds Accumulated central processor time/ 1000 
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TRANSLATE CONTROL STATEMENT 

Translate control statement (TCS) processes user requests to read a control statement 
from or place a control statement in the control statement stream. The only common deck 
required for absolute assembly is COMCSYS. 

The format of the RA+1 call is: 



59 



RA+I 



40 



35 



23 



17 



TCS 


' 


% 


code 


sf 


addr 



Auto recall bit 



code 



Function code: 



sf 



Code 

004 
005 



Macro 

CONTROL 
EXCST 



Subfunction code for the CONTROL macro, 
used for the EXCST macro. 



This field is not 



sf 
00 

01 
02 

4x 



Action 

Read the next control statement and advance 
the control statement pointer. 

Read the next control statement only if it is 
not a local file call. Do not advance the con- 
trol statement pointer. 

Read the next control statement even if it is 
a local file call. If the statement is a local 
file call, set bit 17 of RA+64g. Do not ad- 
vance the control statement pointer. 

If the next control statement being read should be 
processed in product set format, sf is set to 4x, 
where x can be 0, 1, or 2, corresponding to one 
of the above options. If bit 23 of RA+1 is not set, 
control statement parameters are to be processed 
in NOS format. 



addr 



First word address of the buffer in which the control statement 
is to be stored or from which the control statement is to be read. 
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CONTROL (004) 

The CONTROL macro allows the user to read the next control statement in the control state- 
ment stream and transfer it to the address specified. The control statement is checked for 
syntax errors, and all parameters are stored as if a program load had actually taken place. 



If no control statement exists, binary zero words are returned to the buffer, 
statement is of the form: 



If the next 



'!'-comments 

the statement is returned to the buffer if the comments string ends with a period or right 
parenthesis, or if the requesting program was loaded from the system library and contains 
an ARG= entry point (refer to appendix F), Otherwise, the binary zero words are returned 
to the buffer. 

Macro Format: 



lOCATION 


OPERATION 


VARIABLE SUBFIEIDS 




CONTROL 


addr, rss,lf,psf 



addr 



rss 



If 



First word address of the buffer in which the next control 
statement is to be stored. The user should allow room for 
eight words (80 characters). If addr+7 is not less than the 
job's field length, the following message is issued to the 
user's dayfile. 

BUFFER ARC. ERROR. 

If rss is specified (any value may be used), the control state- 
ment pointer is not advanced. This allows the user to deter- 
mine what the next statement is and still allow it to be 
processed. If rss is not specified, the control statement 
pointer is advanced as if the statement had been processed. 

If If is specified (any value may be used), the next control 
statement is read even if the statement calls for the execution 
of a local file; the control statement pointer is not advanced. 
If If is specified and the call is for a local file, the system 
sets bit 17 in RA+648 (ACTR). If If is not specified and rss 
is specified, the next control statement is read only if it is 
not a local file call. Unless the rss parameter is specified, 
the If parameter is ignored. 



psf 



If psf is specified (any value may be used), parameters are 
unpacked in product set format. 



I Refer to appendix F for a description of special entry points, 
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EXCST (005) 

With the EXCST macro the user specifies a buffer containing a control statement. 
Control is transferred from the calling program to the system, which reads the control 
statement, places it in the control statement stream, and processes it. Control is not 
returned to the calling program. The control statement must conform to NOS control 
statement format conventions described in section 5, volume 1. 

IMacro Format: t 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




EXCST 


addr 



addr 



First word address of the buffer containing the control state- 
ment to be processed. The system begins reading at addr 
and continues until the end of statement (zero byte) or end of 
buffer (80 characters) is reached. The control statement 
must be left- justified with zero fill. If the buffer extends 
past the job's field length, the following message is issued to 
the user's dayfile, 

BUFFER A^RG. ERROR. 



CHECKPOINT/RESTART 

A job may be terminated at any time as the result of system, operator, or programmer 
error. For some jobs it becomes more advantageous to accept the overhead of checkpoint 
procedures than to run the risk of losing the entire job output. The ckeckpoint/restart 
feature is implemented through the CKP control statement or CHECKPT macro and the 
RESTART control statement. Refer to volume 1 for discussions of the CKP and RESTART 
control statements. 

CHECKPT 

The CHECKPT macro is used for taking checkpoint dumps. The dump is written on the 
tape or mass storage checkpoint file specified on a REQUEST, ASSIGN, or LABEL control 
statement or REQUEST or LABEL macro. For a general description of checkpoint dumps, 
refer to volume 1. The CHECKPT macro provides the user greater control than the CKP 
control statement in specifying the type of copy to be performed. 



NOTE 



A checkpoint is not allowed in a job step that has 
issued a PROTECT macro selecting user file pri- 
vacy, or in a program which has been loaded from 
an execute only file. 



I This macro is not available in SYSTEXT. The user must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix A). 



60445300 M 



2-10-3 



The format of the RA+1 call is: 



59 



40 



35 



17 



RA+l 



CKP 



sp 



addr 



r 
sp 



addr 



Macro Format: t 



addr 
sp 



Auto recall bit. 

Flag indicating whether or not all files assigned to the job are 
to be checkpointed. If sp is specified (any value may be used), 
only those files specified in the parameter block at address 
addr will be checkpointed. . If the sp field is not specified, 
all local files will be checkpointed. 

Address of the parameter block identifying the files to be 
checkpointed. 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




CHECKPT 


addr,sp 



Address of the parameter list identifying the files to be 
checkpointed. 

Flag indicating whether or not all files assigned to the job 
are to be checkpointed. If sp is specified (any value may be 
used), only those files specified in the parameter block at 
address addr will be checkpointed. If the sp field is not 
specified, all local files will be checkpointed. 



Parameter list format: 

59 47 

param + 
+ I 
+ 2 



+ n 



cn 

n 

c 

Ifn. 
1 

f, 



17 



cn 


M^^^^^^m^^^^^^^ 


n 


fmm 


Ifni 


h 


W///M 


Ifng 


fz 


W///////y. 


■♦ 


• 


• 


V 



Ifn, 



Latest checkpoint number 

Octal number of entries in the parameter list: (0<n<77„) 

Completion bit; set by CHECKPT when the checkpoint is 
complete 

Identifies file to be checkpointed; Ifn. is left- justified 

Specifies the manner in which Ifn. is to be copied: 



tThis macro is not available in SYSTEXT. The user must specify systems text PSSTEXT 
or call common deck COMCMAC (refer to appendix A), 
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fj^ Description 

The file is copied from the BOI to its position 
at checkpoint; only that portion is available 
for restart. RESTART positions the file at 
the latter point. 

1 The file is copied from its position at check- 
point to the EOI; only that portion is available 
for restart. RESTART positions the file at 
the former point. 

2 The entire file is copied, RESTART sets the 
file to its position at checkpoint time. 

3 The last operation on the file determines how 
the file is copied. 

Last Operation 



f Selected 


f. = 
1 





No 


copy 


^i = 


■■ 2 



Write 

Read (EOI detected) 

Read (EOI not detected) 

4 The information table associated with the file 

is copied but the file itself is not copied. The 
information table contains FNT/FST informa- 
tion and the random address of the file. 
RESTART retrieves the file and sets it to its 
position at checkpoint time. If fi=4 and the 
file is a mass storage file, RESTART assumes 
it is an indirect access file and issues a GET 
macro to obtain a working copy. 

The following list shows the type of operation CHECKPT performs for the different 
values of sp and n. 

sp n Operation 



All files assigned to the job at checkpoint time are copied 

according to the last operation performed. 

f'O All files assigned to the job at checkpoint time are copied 

according to the last operation performed. 

. ^0 All files assigned to the job at checkpoint time are copied. 

The n files included in the parameter list are copied ac- 
cording to their respective f values. All other files are 
copied according to the last operation performed. 

/^O ^0 The n files specified in the parameter list are copied ac- 

cording to their respective f values. 

The INPUT, OUTPUT, PUNCH, PUNCHB, and LGO files are always checkpointed; they 
are copied according to the last operation performed (refer to f- = 3), regardless of the 
sp and n values. 

For all other files except direct access files, the default copy type is f=4 when n-^0. 
For direct access files, the type of copy CHECKPT makes depends on the access mode. 
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Mode 


User Option 


w 


Write 


Any type of copyt 


R 


Read-only 


Any type of copy 


E 


Execute-only 


Only f=4 


A 


Append-only 


Any type of copyt 


M 


Modify 


Any type of copyt 


RA 


Read and append 


Any type of copyt 


RM 


Read and modify 


Any type of copyt 



Default 
Copied (f=3) 

Not copied (f=4) 

Not copied (f=4) 

Copied (f=3) 

Copied (f=3) 

Copied (f=3) 

Copied {f=3) 



For a random file the copy type must be f=2 or it will be copied according to the last 
operation performed (f=3). 



REPRIEVE PROCESSING 

Reprieve processing (routine RPV) enables the user to intercept interrupts prior to an abort 
of a program and to take corrective action. This action can be the completion of files (such 
as flushing buffers or closing files) and tables or it may be an attempt to correct the 
problem. 

The format of the call to RPV is as follows; 



59 



40 



17 



RA + I 



RPV 



/r 



addr 



Auto recall bit (must be set) 

First word address of the parameter block 

RPV supports the following functions. 



r 
addr 



• Setup 

• Resume 

• Reset 

The setup function is used to initialize the parameters for the RPV interface (that is, 
setting the mask bits that indicate which errors are to be intercepted). It also initial- 
izes all RPV data in the user's control point area; if the parameter block indicates 
pending interrupts or I/O requests, these are processed at that time. 



I If f=4 is selected, the user must retrieve the file himself at restart time and select the NA 
and FC options on the RESTART control statement (refer to section 12, volume 1). 
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The resume function is used to restart the program after an interrupt has been processed. 
Any pending interrupts that occurred during the processing of the previous interrupt are 
detected then and the interrupt handler is restarted to process these interrupts. Optionally, 
the mask bits can also be changed during the resume function. Two modes of resume are 
allowed: program mode and interrupt handler mode. 

Program mode resume assumes that the interrupt handler has completed processing of the 
interrupt and the program is to be restarted as though the interrupt had not occurred. 

Interrupt handler mode resume restarts the executing program as a part of interrupt 
processing until a logical interrupt point is reached. This allows the interrupt handler 
to remain active over an interrupt handler mode resume so that, after required process- 
ing has completed, a reset function can be issued to reset the error flag. 



NOTE 



Before issuing a resume function, the interrupt 
handler must ensure that the pending RA+1 re- 
quest is valid or zero (it is recommended that 
the user check if bits 59 through 42 are zero 
and then clear the entire word from the reprieve 
block before issuing the resume). The system 
returns the contents of the program's RA+1 to 
the reprieve parameter block at the time of the 
interrupt. This may contain system information 
rather than a valid RA+1 call if an outstanding 
RA+1 request with recall is in progress. 

The reset function is used to reset a previous error flag and allow the operating system 
error handling routines to process the error. That is, the mask bits are cleared to disable 
further reprieve processing and the system processes the error as if the appropriate mask 
bit had not been set. Pending interrupts are not processed; however, any pending RA+1 
request is reset and the exchange package is reset from the reprieve parameter block. 



NOTE 



A terminal interrupt sets a pseudo error flag. 
Beset of a terminal interrupt is treated as if 
there were no error and causes the program to 
resume execution, using the exchange package 
from the reprieve parameter block. 
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The format of the parameter block is as follows: 



59 



35 



29 



23 



II 9 



addr + 
+ I 
+ 2 
+ 3 
+ 4 
+ 5 
+ 6 
+ 7 
+ 8 

+ 9 

• 



+24 






length 





f unc 


c 


checksum Iwa 


transfer address 


checksum value 


mask 


error class 


error code 


pending interrupts 


pending RA+I request 


interrupted terminal I/O 


reserved 


error flag 


reserved 


reserved inst. 


exchange package 



length 
func 



Length of the parameter block including the exchange package 
area (minimum of 25 words). 

Function code: 

1 Setup 

2 Program mode resume (RESUME) 

3 Reset 

4 Interrupt handler mode resume (IRESUME) 
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c Completion bit (set by RPV when operation is complete). 

checksum Specified by the user to indicate the end of the area to be 

hva checksummed and compared or set. If zero, no checksum 

is desired (checksum area begins at transfer address). 

transfer Address to which control is transferred when an interrupt 

address is processed. 

checksum Either set to the checksum of the indicated area when RPV 

value is called, or compared against the computed checksum (if 

checksum Iwa is specified) when a reprievable error is 

processed. 

mask Mask bits to be set by call: 



mask 



Description 



001 


CPU error exit 


002 


PP call error 


004 


SRU limit 


010 


Operator termination 


020 


PP abort 


040 


CPU abort 


100 


Normal termination 


200 


Terminal interrupt 



error class 



error code 

pending 
interrupts 



Set to the value of the mask bit v/hich intercepts the indicated 
error (that is, if error x is intercepted by mask bit n, then bit 
n in the error class field is set). Refer to table 2-10-1 for a list 
of error classes. 

Octal code indicating error encountered. Refer to table 2-10-1 
for a list of error codes and their meanings. 

Used to queue pending interrupts (that is, the nth error code 
sets bit n in this field). 



pending RA+1 Contents of RA+1 at time of interrupt, 
request field on a resume or reset call. 



RA+1 is reset from this 



interrupted Contains interrupted input request if an interrupt occurs 
terminal l/O while a terminal input request is pending. The format is 
as follows: 



59 



35 



17 



ClOP 





F E T address 



error flag 

reserved 
inst. 

exchange 
package 



Value of the operating system error flag at the time of the 
interrupt (refer to EREXIT macro in section 6). 

This area is reserved for use by the installation. 

A copy of the exchange package at the time of the interrupt 
(unchanged from the executing package at the time of the 
error). This is the exchange package that is used when the 
interrupt handler is started. 



Table 2-10-1 lists the return information for RPV error codes, classes, and flags. 
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TABLE 2-10-1. RPV ERROR CODES. CLASSES, AND FLAGS 



Error 




Error 


Corresponding 


Code 


Description 


Class 


Error Flags 





Normal termination 


100 


None 


1 


Time Limit 


004 


TLET 


2 


CPU error exit 


001 


ARET, PEET. PSET 


3 


PP abort 


020 


PPET 


4 


CPU abort 


040 


CPET 


5 


PP call error 


002 


PCET 


6 


Operator drop 


010 


ODET 


7 


Operator kill 


010 


SSET, OKET, 
ORET, SYET, FSET 


10 


Operator rerun 


010 


RRET 


11 


Control statement error 


040 


None 


12 


ECS parity error 


020 


ECET 


15 


Auto recall error 


002 


None 


16 


Job hung in autorecall 


002 


None 


17 


Mass storage limit 


004 


FLET, TKET 


20 


PP program not in 
library 


002 


None 


21 


I/O limits 


004 


SRET 


40 


Terminal interrupt 


200 


TIET 



Refer to appendix B for a list of error messages issued by RPV. 

REPRIEVE 

The REPRIEVE macro provides access to the extended reprieve processing capabilities of 
RPV. REPRIEVE parameters are inserted into the designated positions in the parameter 
block. Other fields are the responsibility of the caller. 

Macro Format: t 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




REPRIEVE 


addr, type, mask 



addr 
type 

mask 



Address of the parameter block 

Type of call: SET, RESET, RESUME (program mode), or 
IRESUME (interrupt handler mode) 

Desired mask setting 



tThis macro is not available in SYSTEXT. The user must specify systems text PSSTEXT 
or call common deck COMCCMD (refer to appendix A). 
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The REPRIEVE macro issues the RA+1 request without using common deck COMCSYS since 
the routine is not reentrant and the interrupt could have occurred there. Users should be 
aware of access by the interrupt handler to any other portions of the program which may not 
be reentrant and shared with noninterrupt handler code. 

One way a user can avoid this problem is to qualify the macros used in the interrupt handler 
that use COMCSYS to issue the requests, and also provide a qualified copy of COMCSYS to 
ensure that no conflict exists. The following example illustrates this process with the 
MESSAGE macro. 

Interrupt handler code 



QUAL IHX 
MESSAGE ERR 1,3 
QUAL - 



ERRl 


DATA 


C=:= SOME ERROR 




QUAL 


IHX 


OPL 


XT EXT 
QUAL 


COMCSYS 



Refer to the DISTC macro in section 12 for a description of the methods by which a user 
program can control the processing of terminal interrupts. Error flags can be set by 
using the MODE macro described in section 6. 



RECOVR 



The RECOVR macro enables the user to perform normal reprieve processing via the 
RECOVR macro. RECOVR does not support extended reprieve capabilities. This means 
that if an error is trapped as a result of a RECOVR macro, it is not possible to RESET 
the error or RESUME the program at the point of interrupt. These capabilities are only 
available with the REPRIEVE macro. 



Macro Format rf 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




RECOVR 


addr,mask, chk 



addr 

mask 

chk 



Address of recovery routine 

Mask bits (refer to REPRIEVE macro) 

Checksum last word address (0 if no checksum desired) 



The RECOVR macro cannot be used to process terminal interrupts. However, the user 
can issue a DISTC macro (refer to section 12) in addition to a RECOVR macro. 



f This macro is not available in SYSTEXT. The user must specify systems text PSSTEXT 
or call com.mon deck COMCCMD (refer to appendix A). 
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The RECOVR macro cannot be used to process terminal interrupts. However, the user can 
issue aDISTC macro (re^er to section 12) in addition to a RECOVR macro. 
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SYSTEM/LOADER REQUESTS 



11 



SYSTEM REQUESTS 

The following requests perform miscellaneous tasks associated with a job. Most of the 
requests are processed by the system monitor directly rather than by a specific function 
processor. The calling format is shown for each macro. Unless otherwise noted, the 
only common deck required for absolute assemblies is COMCSYS. 

ABORT 

The user can request the monitor to set the error flag at the control point when a program 
error occurs by using the ABORT function. If the control statement record of the job deck 
contains an EXIT statement, the system continues job processing with the control state- 
ment that immediately follows the EXIT statement. This process can be altered by reprieve 
processing (refer to section 10). 

The format of the RA + 1 call for this function is: 



59 



35 



RA+I 



ABTP 



Macro Format: 



LOCATION 



OPERATION 



VARIABLE SUBFIELDS 



ABORT 



DAYFILE 

The DAYFILE macro enables the user to access the job dayfile. 
words must be specified. 



A FET of at least seven 



A portion of the dayfile resides in the system central memory buffers. This is transferred 
to the buffer in the user's field length specified in the FET (FIRST). The user must ensure 
that the buffer specified is large enough to accommodate the central memory portion of the 
dayfile. The released size is lOOs. If the buffer is too small the following message is 
issued: 

SFM ARGUMENT ERROR. 
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That portion of the dayfile that resides on mass storage is made available to the user as a 
library file assigned to the control point in read-only mode. If a local file with the same 
name as the file name specified already exists, it is returned. The file is positioned at 
BOI. If the dayfile specified does not exist, the following message is issued: 

SFM ILLEGAL REQUEST. 

This macro requires common decks COMCSFM and COMSSFM for relocatable and absolute 
assemblies and COMCSYS for absolute assemblies. 

The format of the call to SFM is: 



RA+I 



59 




40 


35 


23 


7 


SFM 


^^^ 


^ 


0005 


id 


Qddr 



r 

id 

addr 



Auto recall bit 

File identification number 

Address of the FET for the file 



The format of the FET used by SFM is: 
59 53 47 ' 



FET + 
+ I 
+ 7 



dt 



23 



Ifn 



w/A e, i^^^^^^^^mM^ 



0005 



Ifn 

dt 

eq 

Macro Format:! 



addr 
type 



Local file name 

Device type (refer to appendix E) 

Equipment number 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




DAYFILE 


addr, type 



Address of the FET for the call; name given to the mass 
storage portion of the file 

USER (function 0005); attach user's dayfile. This is the day- 
file of the job currently running. 



tThis macro is not available in SYSTEXT. The user must specify system text PSSTEXT 
or call common deck COMCMAC (refer to appendix A). 
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The reply to this macro is: 



59 



FET + 5 
+ 6 



recovered doyfile length 



current dayfile length 



The following example reads the user dayfile and writes it to OUTPUT, 



CBUFL 

BUFL 

WBUFL 

I 
SCR 


OUTPUT 

VIDCT 
** 

DAYF 



DAYl 
DAY 2 



IDENT DAYF 
ENTRY DAYF 
SYSCOM Bl 

ASSEMBLY CONSTANTS. 

EQU 400B 
EQU 301 B 
EQU 300B 

FETS AND CONSTANTS. 



RELEASED CM BUFFER LENGTH 
DAYFILE/OUTPUT BUFFER LENGTH 
WORKING BUFFER LENGTH 



BSS DAYFILE 

FILEB IBUF,BUFL,FET=7 

BSS OUTPUT 

FILEB 0BUF,BUFL,FET=7 



DATA 
MAIN PROGRAM. 



WORD COUNT OF CM BUFFER 



SBl 1 

DAYFILE I, USER 

SAl I+l 

SA2 Al+1 

SXl XI 

1X6 X2-X1 

ZR X6,DAY1 

SA6 WDCT 

READW I,CBUF,X6 READ CM BUFFER 



COMPUTE CM BUFFER WORD COUNT 



IF CM BUFFER EMPTY 



READ I INITIATE FILE READ 

READW I,WBUF,WBUFL 

NZ XI, DAYS IF TRANSFER COMPLETE 

WRITEW 0,WBUF, WBUFL 

EQ DAY2 
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DAY 3 SX2 B6-WBUF 

ZR X2,DAY4 

WRITEW 0,WBUF,X2 



SET WORDS TRANSFERRED 
IF NONE 
EMPTY BUFFER 



DAYA 


SA2 


WDCT 




ZR 


X2,DAY5 




WRITEW 


0,CBUF,X2 


DAYS 


WRITER 







RETURN 


I 




ENDRUN 




:* 


COMMON 


DECKS. 


OPL 


XTEXT 


COMCSFM 


OPL 


XTEXT 


COMSSFM 


* 


BUFFERS . 


IBUF 


BSS 


BUFL 


OBUF 


BSS 


BUFL 


CBUF 


BSS 


CBUFL 


WBUF ■ 


BSS 


WBUFL 



GET CM BUFFER WORD COUNT 
IF CM BUFFER EMPTY 
WRITE CM BUFFER 



DAYFILE BUFFER 
OUTPUT BUFFER 
CM BUFFER 
WORKING BUFFER 



END 



DAYF 



ENDRUN 

The ENDRUN function requests normal termination of a program. NOS examines the 
control statement record of the job input file and begins execution with the next unused 
control statement. If there are no more control statements or if the next statement is an 
EXIT statement, the system terminates the job. 

The format of the RA+1 call for this function is: 



59 



35 



RA+I 



ENDP 






Macro Format: 



LOCATION 



OPERATION 



VARIABLE SUBFIELDS 



ENDRUN 
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GETMC 



The GETMC macro allows the user to obtain information about machine characteristics 
and the system environment. Common deck COMCCVL is required for absolute and re- 
locatable assemblies. 

Macro Format: t 



LOCATION 



addr 



OPERATION 



GETMC 



VARIABLE SUBFIELDS 



addr 



Address to receive machine characteristics 



The format of the RA+1 call for this function is; 

59 35 

RA+I 



n 



CVLP 


0002 


addr 



The machine characteristics are returned in the following format. 
59 47 35 23 II 



addr 



cs 

ecs 

PP 

mc 



cm 
c 



2ll 



ecs 



PP 



mc 



cm 



If bit 48 is set, system is operating in 64-character set mode. 
If bit 48 is clear, system is operating in 63-character set mode, 

Extended core storage (ECS) size/lOOOo 

Number of PPs in system 
Machine characteristics 



Bit No. 

23-20 

19-18 

17 
16 
15 
14 
13 
12 



Description 



Unused 



Nonzero if CPU is a CYBER 170, Model 176; zero if 
CPU is not a Model 176 

Unused 

Set if machine is CYBER 170 

Set if compare move unit (CMU) option is present 

Set if CEJ/MEJ option is present 

Set if CPUO has instruction stack 

Set if CPUl is present 



Central memory size/200g (set to 37773 ^^ central memory = 262K) 
Completion bit (set when operation complete) 



tThis macro is not available in SYSTEXT. The user must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix A). 
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MEMORY 

Using the MEMORY function, the user can determine or change the amount of central 
memory or ECS associated with his job or determine the maximum amount of memory- 
he can request. 

The format of the RA+1 call for this function is: 



59 



40 



35 



17 



w 



RA-M 



RFL 



Stat 



words 



Alternate call format: f 



59 



40 



17 



RAfI 



MEM 



ttot 



Macro Format: 



lOCATION 


OPERATION 


VARIABLE SUBFIEIDS 




MEMORY 


type, Stat, r, words, na 



type CM or null for central memory; either is legal. ECS for 

extended core storage. 

Stat Status word address. May be omitted only if the words 

parameter is specified and na is null. 



tTo maintain compatibility with NOS/BE. 
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r If specified, control is not returned until the request is 

complete. If omitted, control may be returned before the 
request is complete. In this case, bit of the stat word 
is set to indicate completion. 

words Desired new field length which, if specified, overrides the 

stat wor<l. If words is specified, the MEMORY macro sets 
the upper 30 bits of the stat word to the value of words, 
A negative value may not be used for words. 

na If null, the program is aborted if the user's request ex- 

ceeds the current maximum which he is allowed. If this 
parameter is specified, the program is not aborted if the 
request exceeds the current maximum. Instead, the macro 
does not change the field length, and sets the stat word as 
defined below. 

The stat word (if used) has the following format. 

59 29 3 

stat 



vol 





rs c 



val Prior to the macro call, val is used to specify the desired 

new field length (words parameter can override this value). 
If val (or words) is +0, then the current field length for the 
specified type is returned in this field. If bit 47 of val is 
set and specified type is CM, a memory reduction is honored 
even if no reduce has been selected (that is, no reduce over- 
ride is in effect), t If val is -1, then the current maximum 
field length for the specified type is returned; if user ECS is 
disabled or not present, a value of zero is returned in val, 
regardless of any validated ECS field length. If val (or 
words) is greater than zero for the macro call, it contains 
the actual value assigned upon return. If val is -0 and type 
is ECS, the field length is set to 0. 

rs These bits are reserved for system usage. 

c Completion bit. The system sets this bit when the request 

is complete. 

If a request is given for an amount greater than the current maximum (refer to the Installa- 
tion Handbook for a description of the current maximum field length) and if na is specified, 
then no field length change occurs and control is returned with val set to the current field 
length value. 

If the reserved bits (rs) in the status word are used, the MEMORY request or a subsequent 
MEMORY request may be aborted with the following dayfile message. 

ILLEGAL COMMON MEMORY MANAGER REQUEST. 



tRefer to the REDUCE (-) control statement in the CYBER Loader Reference Manual. 
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MESSAGE 

The MESSAGE function allows the user to display a message on the system console display 
and enter it in a dayfile. 

If the job is of system origin, the message may be flashed on the B display by including a 
dollar sign as the first character of the message and routing the message with option 2. 

The maximum length of a message is 80 characters; up to 40 characters per line are dis- 
played. The message ends with either the first word containing 12 bits of zeros in any 
byte or at the 80th character. Before issuing the MESSAGE function, the user must pack 
the display coded message in sequential locations, beginning at location addr. 

The format of the RA+1 call for this function is: 



59 



40 



35 



23 



17 



1 



RA+ I 



MSG 



addr 



Macro Format: 



LOCATION 


OPERATION 


VARIABLE SU8FIELDS 




MESSAGE 


addr, x, r 



addr 



Beginning address of the message. The beginning address 
of the message cannot be within five words of the end of the 
user's field length. 



Message routing option 



x=0 

x=l 
x=2 
x=3 

x=4 



x=5 



x = 6 



x=7 



Message is placed in the system dayfile, the user 
dayfile, and displayed at line 1 of the control point 

Message is displayed at line 1 of the control point 

Message is displayed at line 2 of the control point 

Message is placed in the user dayfile and displayed 
at line 1 of the control point 

Message is placed in the error log dayfile if job is 
special system job (that is, has an SSJ= entry point) 
or is of system origin; or user dayfile if not SSJ= 
or system origin 

Message is placed in the account dayfile if job is 
special system job or is of system origin; or user 
dayfile if not SSJ= or system origin 

Message is placed in the system dayfile, the user 
dayfile, and displayed at line 1 of the control point f 

Message is placed in the user dayfile and displayed 
at line 1 of the control pointf 



t Provided for compatibility with NOS/BE. 
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If X is not specified, x=0 is assumed. If x is not defined or is 
an illegal positive value, x=l is assumed. If x is a negative 
number, unpredictable results will occur. If x is the char- 
acter string LOCAL, x=3 is used. 

The control point message areas (lines 1 and 2) provide the 
user with the ability to display concurrently messages that 
enter the dayfile and those that require operator action. 
Line 2 is normally used to display information about the 
current status of the executing program; for example: 

SKIPPING Ifn 

COPYING Ifn 

ASSEMBLING TEST 



Only messages that are of interest to other than the job, such 
as the control statements processed and compilers used, 
should be placed in the system dayfile (x=0). All messages 
of interest to the job, such as the path taken by the programs 
and the number of records copied, should be placed only in 
the user dayfile (x=3). All messages placed in the user 
dayfile (x=0 and x=3) are counted by the system. If the 
number of messages issued by the job exceeds the limit for 
which the user is validated, the following error message is 
issued to the user dayfile and the job is aborted. 

MESSAGE LIMIT. 

r If r is specified, control is not returned until the operation 

is complete. 

If the MSG RA+1 request is issued directly (not using the macro) and the upper 12 bits of 
the location specified by the message address are zero, then bits 47 through 30 of this 
location are assumed to contain the beginning address of the message. This indirect 
addressing method is not supported by the macro call and unpredictable results will occur 
if it is attempted. 
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MOVE 



The MOVE macro moves a block of data from addri to addr2. 
the common deck COMCMVE for absolute assemblies. 



This macro requires 



Macro Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




MOVE 


count, addr^, addr^ 



count Number of words in the block to be moved 

addri Address of the first word of the block to be moved 

addr2 Address of the first word of the destination 

MOVE allows overlap in data moves; in other words, addr2 can be less than addrj 
plus count. 



RECALL 

The RECALL function enables the user to relinquish the CPU until a function is 
completed or the CPU recall time has elapsed (delay time is set by the installation, 
usually 1/2 second). If the stat parameter is included in the call, control is not 
returned to the program until bit of the word specified by stat is set. If stat is 
not included in the macro call, the program relinquishes the CPU only until the next 
pass through the recall loop. 

The format of the RA+1 call for this function is: 



59 



40 



17 



RA+ I 



RCL 



/r 



stat 



Macro Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




RECALL 


Stat 



stat 



If this parameter is present, control is returned to the 
program when bit of the word specified by the address 
stat is set. 
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SUBR 



The subroutine macro enables the user to distinguish between entering a subroutine and 
exiting from a subroutine even though control is transferred to the same address. 
Transfers to the subroutine are of the form: 

RJ tag 
Exits from the subroutine are of the form: 

EQ tagX 
Macro Formatrf 



LOCATION 


OPERATION 


VARIABIE SUBFIEIOS 


tag 


SUBR 





SYSTEM 



With the SYSTEM function, the user can request the system to process any three-character 
requests. Refer to Request Processors, section 1, for a list of request processors. 
A PP program can be called from a CPU program if the first character of the name is 
alphabetic. Documentation of these programs (refer to DOCMENT statement, section 7, 
volume 1) should be consulted for the functions available (for example, LFM, CPM). 
These should be used when macros do not exist to issue the functions desired. 

The format of the RA + 1 call is: 



59 



RA+I 



req 



40 35 

em: 



17 



^^ 



P2 



P| 



t This macro is not available in SYSTEXT. The user must specify systems text PSSTEXT 
or call common deck COMCMAC (refer to appendix A). 
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Macro Format: 



lOCATION 


OPERATION 


VARIABLE SUBFIELDS 




SYSTEM 


req, r, p^,P2 



req 
r 

Pi 



Three- character system request 

If specified, control is returned only after the request is 
completed 

Bits 17 through of the request 

Bits 35 through 18 of the request 



Example 1 : 

If the user wishes to dump the contents of locations 1000 to 4000 and recall the CPU 
when the dump is completed, the SYSTEM request is: 

SYSTEM DMP,R,4000B,1000B 

Example 2 : 

If the user wishes to dump the display code equivalent of the data dumped in example 1, 
the SYSTEM request is: 

SYSTEM DMD,R,4000B,1000B 

Example 3: 

If the user wishes to dump the contents of locations 1000 to 4000 of ECS and recall 
the CPU when the dump is completed, the system request is formatted as follows: 

SYSTEM DEP, R,addr 



Location addr has the following format. 

59 47 

addr 



23 






1000 


4000 



The same procedure is followed if the display code equivalent of ECS is desired using 
the following system request. 

SYSTEM DED,R,addr 

Example 4: 

If the user wishes to issue a CIO function request, he can do so with the following 
SYSTEM request: 

SYSTEM CIO, r, addr, n 
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where adder is the address of the FET for the file being read and n is the count for skip 
operations. If r is specified, the request is made with auto recall. When performing a 
CIO request in this manner, the user must set the function code in FET+0. 



LOADER REQUESTS 



The system provides routines to aid the user in loading overlays or capsules at 
specific points during program execution. The overlays or capsules can reside on files 
attached to the user's job or in system libraries. 



OVERLAY 

The OVERLAY macro processes a system request to the LDR processor. LDR provides 
the ability to load overlays to specified areas of the user's program area. Depending on 
the parameters specified and the level of the overlay, control may or may not be returned 
to the calling program. 

The format of the RA + 1 call for this function is:t 

59 40 17 



RA+ I 



LDR 



a 



addr 



r Auto recall, if desired 

addr Address of the request 

The load request consists of two to four words. The two- to four-word block must be 
defined by the user for RA+1 calls, but is defined by the system when called from the 
OVERLAY macro (only two words used). 



59 



addr 



53 



47 



40 35 



17 



name 





^1 


^2 


n 





u 


V 





e 


Iwa 


fwa 


oviname 





eptname 






name Source of name depending on the u and n options 

H 2 First overlay level 

H 2 Second overlay level 

n Number of words in request-2 (bits 47-46) 



t LDV is processed by the system as the LDR call. This is to provide compatibility with 
the common product set. 
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u Load option (bit 42) 

V Overlay flag (must be set to 1) (bit 41) 

e Call completion flag (bit 36) 

Iwa Last word address available for load 

fwa First word address of the overlay 

ovlname Name of overlay to be loaded (if n/0) 

eptname Entry point name when loading multiple entry point overlay 
(if n=2) 

The operation performed depends on the value of u, n, fwa, j5 p and ft 2- 

1. If u=0, n is ignored and name is the name of the file containing the overlay 
in ^ and jf 2 a^e required). 

2. If u=l and n=0, name is the name of the overlay from the system library 
ii ^ and H 2 are ignored). 

3. If u=l and n^O, ovlname is the name of the overlay from the system library 
(jE j and jC 2 are ignored). 

4. If fwa=0, the overlay is loaded at the address specified by the overlay. 

5. 1£ H i=!t 2~0» the (0, overlay) control is returned to the called overlay; otherwise, 
control IS returned to the caller with fwa=entry address. 

6. If e=l, control transfers to the specified entry point, eptname, in the overlay. 



Upon completion of the load, information is returned to addr as follows; 



59 53 47 



17 



addr 



name 





^1 


^2 





eptaddr 


ovlname 





eptname 






eptaddr Entry point address of the overlay; if n=2, eptaddr is 

the address of eptname. 
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Macro Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




OVERLAY 


nam, lev, SYSTEM, fwa 



nam Address of file name in L format (display code, left-justified). 

lev Level of overlay. If not specified, level 0, is assumed 

and control is automatically transferred to transfer address 
encountered on overlay load. (Usually specified on IDENT 
instruction of ABS programs. ) For overlay level (i, j), 
level is defined as: lev=i='=100n+j . 

SYSTEM If SYSTEM is specified, file is loaded from system library 
and nam is name of overlay desired, 

fwa If this parameter is specified, fwa is the address where 

the overlay is to be loaded. The file is loaded at the 
address specified on the overlay if this parameter is not 
specified. 



Common decks required are COMCOVL and COMCSYS. 

After the macro is processed, XI contains the address of the entry in the overlay. 

Example 1 : 



OVERLAY TEST 



TEST CON 



4LTEST 



This sequence of code loads overlay 00 from file name TEST and begins execution at 
the entry address specified by TEST. 



Example 2: 



OVERLAY A, OlOOB, S, LDA 
SB2 XI 

JP B2 



A 



CON 5LARITH 



LDA 



EQU 
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This sequence of code loads the ARITH routine from the system (level 1, 0) library at 
address LDA and transfers control to the routine. 

If the request calls for the overlay to be loaded and executed and no fwa load address 
is specified in the request, the entry point address specified in the load table is used 
as the entry point address. If an fwa load address is specified in the request, bias 
the entry point address from the load table with the difference of the fwa load address 
specified by the request and the fwa load address specified by the load table; that is: 



Entry point address 



= (entry point address from load table) + (fwa load address 
specified in the request) - (fwa load address from load 
table) 



If the request requires just an overlay load, the entry point address returned is the 
entry point address in the load table. 



LOADD 

The LOADD macro allows the user to locate fast dynamic load (FDL) capsules or 
CYBER Control Language (CCL) procedures and have pertinent information returned to 
a specified address. Fast dynamic loading is a method of loading preprocessed binary 
routines. 

The format of the RA+ 1 call for this function is: 



59 



40 



17 



RA+I 



LDD 



addr 



r 
addr 



Auto recall bit 

Address of parameter block 



The parameter block consists of two words in the following format. 





59 




47 




29 




17 




8 





addr + 


group name 


Stat 


fc 


+ 1 





liblist 


dirlen 


directory 



group name Name of the group of capsules or procedures for which a 
directory is requested. 

Stat Status of call (ignored during request). Upon completion 

of call, stat is set to one of the following values. 



Value 


1 
2 



Description 

Function completed without error 

Illegal function code 

Bad directory address or length (address 

plus length must be less than or equal to 

field length) 

Bad liblist address or length 
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fc 



liblist 



The following errors may be combined with those preceding. 



108 



20 



8 



Function code, 
is complete. 



404o 



An entry in the library list did not cor- 
respond to any known local or system library 
name, or an entry specified the name of a 
file which was not a mass storage library 

The specified directory space was not large 
enough to contain the entire directory 

LDD sets bit zero to one when the request 



Specifies capsule (record type CAP) 

Specifies procedure (record type PROC) 

Address of a list of libraries to be searched after the global 
library set. Zero if no set is specified. 



dirlen 



directory 



Length, in central memory words, of the area to receive 
the generated directory. Upon completion of the call , it 
is set to the actual length that was needed for the complete 
directory (may be less than or equal to the value of the 
original call). 

Address of the area to receive the generated directory. 



When called, LDD searches first the global library set (refer to the CYBER Loader 
Reference Manual for a description of global library sets) and then the library set speci- 
fied in the call. If a library file is found to contain one or more capsules belonging to 
the given group or the specified procedure, an entry is made in the directory. This 
entry is one of two different forms, depending on whether the library is a system library 
or a local file library. For a procedure, LDD searches the central library directory 
(CLD) if the specified procedure is not found elsewhere. 



For a local file library the format is: 

59 



17 



1 


local file name f 






For a system library the format is: 

59 47 



23 



17 



7777 





libord 


° 1 



libord 



The library ordinal of the library containing the capsule 



t The first character of the local file name cannot be numeric. 
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For each capsule or procedure found that belongs to the given group, LDD makes the 
following entry in the directory. 

59 56 35 17 



;r 



faddr 



caddr 
daddr 



caddr 



daddr 



faddr 



length 



Address, relative to the beginning of the directory, of the 
word containing the file entry associated with this capsule 
or procedure. 

Residence of capsule or procedure: 



Mass storage 

Mass storage and CM 

Mass storage and ECS 



CM or ECS address of capsule or procedure 

Disk- address (relative PRU) of capsule or procedure 



length 



Length of the capsule or procedure, including header, 
code image, and relocation and linking information, but 
excluding the prefix table. 



Macro Format:! 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




LOADD 


addr, r 



addr 
r 



Address of parameter block 
Auto recall 



LOADQ 

The LOADQ macro loads fast dynamic load (FDL) capsules or overlays from specified 
files. 

The format of the RA+ 1 call for this function is: 



RA + l 



59 


40 


7 


LDQ 


I 





addr 



r 
addr 



Auto recall bit 

Address of parameter block 



t This macro is not available in SYSTEXT. The user must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix A). 
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The four -word parameter block must be defined as follows: 

59 17 

addr+0 

+ 1 

+2 

+ 3 



file name 


Stat 


- 


group name 


W//////////A 


capsule or overlay name 


fwa 


random address 


Iwa + I 



file name 

stat 



fc 



group name 

capsule or 
overlay name 

fwa 



random 
address 

lwa+1 



Name of file containing capsule or overlay 

Status of LDQ call (ignored during request). Upon comple- 
tion of call, stat is set to one of the following values. 

Value Description 

Function completed without error 

1 Illegal function code 

2 Bad address (must have fwa<lwa+l<field 
length) 

3 Nonexistent file or file not on mass storage 

4 Bad disk address (out of file bounds) 

5 Capsule or overlay not found at specified 
location 

6 Insufficient space provided for capsule or 
overlay 

If either error 5 or 6 occurs, the contents of the loadable 
area are undefined. 

Function code; 

Load capsule 

2 Load overlay 

LDQ sets bit zero to one when the request is complete. 

Name of capsule group; zero for overlay load 

Name of desired capsule or overlay 

First word address of the area into which the capsule or 
overlay is to be read 

Location of capsule or overlay on specified file 

Last word address plus 1 of area for capsule or overlay 
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LDQ reads a capsule or overlay from the specified mass storage location, removing 
the prefix table, but not altering the record otherwise. LDQ ensures that the location 
contains a capsule (60 table), if a capsule load is requested, or an overlay (50, 51, 53, 
or 54 table), if an overlay load is requested. LDQ also determines that the entire 
capsule or overlay fits into the specified area and that the name is correct. 

Macro Format:! 



LOCATION 


OPERATION 


VARIABLE SUBFIEIDS 




LOADQ 


addr, r 



addr 
r 



Address of parameter block 
Auto recall 



t This macro is not available in SYSTEXT. The user must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix A). 
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In using the first method, the system uses the first file that meets the following cri- 
teria. 

• The file must either be assigned to the terminal (device type equals TT in the 
FET) or, if unassigned, must be named OUTPUT. 

• The file must meet the conditions described under the flush bit (refer to des- 
cription of flush bit, FET Description, in section 2), 

In using the second method, the system checks only the first file in the list. It must 
meet the criteria above. 



OTHER SPECIAL HANDLING 

The following additional considerations should be noted by those attempting to write 
interactive programs. 

• An EOR or EOF write on a terminal file has no special significance except 
that it ensures that the buffer is dumped to the terminal. 

• When terminal input data is passed to an executing program, the following con- 
vention is followed. 

If an odd number of characters is entered, the last character plus 1 is a space. 

If the input data consists of data followed by a carriage return, the program has 
a five-word FET, the system supplies an EOR level of zero (level number is in 
bits 17 through 14 of the FET code and status word). If the program has a 
six-word or larger FET, the system supplies an EOR level of 1. If there is 
no data input but only a carriage return, an EOF is supplied by the system. 

Thus, a program can determine if input is from a terminal by using six-word 
or longer FETs and by sensing an EOR level of 1. The system input/output 
macros and common decks are coded to handle this case properly. Thus, 
most of the system utilities interact with a terminal. 

Input to an executing program is handled in the same manner as the CIO 
READSKP request. If the user's buffer is not large enough to accommodate a 
full line of input, the data is truncated and the excess is lost. No error code 
is returned. 

• A program that is interacting with a terminal should not do a recall on a file 
assigned to a terminal if it does an EOR or EOF write on the file to clear the 
buffer (do not specify the r option on WRITER or WRITEF macros). If recall 
is specified, an extra rollout of the program is required before the program 
terminates. If the conventions mentioned earlier concerning the status of out- 
put are followed, it is not mandatory to write an EOR or EOF to clear the buf- 
fer; however, if it is done (to remain compatible for batch use, for example) 
as the last operation before placing END in RA+1 (ENDRUN macro) without re- 
call, little system overhead is incurred. 

• If the conventions for special handling are followed, a job being rolled out by 
the system has all completed lines of data in the output buffer sent to the 
terminal. 
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• If a job terminates because an error flag is set, the contents of the first 
message buffer of the control point area is sent to the terminal as part of 
the output. When the user is in the BATCH subsystem, this message buffer 
is always sent to the terminal on job termination. Messages can be placed 
in this area using the MESSAGE macro. Messages longer than 48 char- 
acters are truncated to 48 characters. 

• If a buffer argument error is detected on an output buffer when output is being 
issued automatically, the output is ignored and the FET is not acted on. This 
error usually indicates that the executing program has destroyed part of its 
own field length. 

• If the user program destroys its input FET after the FET has been validated 
by CIO, but before the data is actually passed, the input request is ignored. 
The probability of either of these occurrences is extremely remote. 

• A COMPASS program can determine whether it is interacting with a terminal 
by checking the origin type that is passed or by checking the type of equipment 
to which the file was assigned (byte of FET+1). Refer to the common deck 
COMCSTF, appendix A. 



PROGRAM CONTROL OF TERMINAL ACTIVITY 

The remainder of this section describes methods of controlling terminal activity when 
connected to the time-sharing executive. Two versions of the time-sharing executive 
exist: the Interactive Facility (lAF) which has a Network Access Method (NAM) inter- 
face; and a time-sharing subsystem which uses multiplexers to interface with terminals. 
The NAM interface uses 255x series communications processors. A network terminal 
is a terminal using the NAM interface. 

The following discussions apply to both versions of the time-sharing executive, unless 
specifically restricted to network terminals (that is, those using NAM and lAF). 

The user can control terminal activity in the following ways. 

• Include control bytes in his output to control the positioning of the printing 
element and define alternate input modes, t 

• Enter various characters or sequences of characters to control program exe- 
cution. 

• Issue a REPRIEVE (refer to section 10) or DISTC macro to disable the termi- 
nal operator's control of his program during various phases of execution. 

• Issue a CSET macro to change the character set of the terminal. 

• Issue a PARITY macro to change the parity of the terminal, tt 

• Issue a PROMPT macro to control the issuing of the input prompt. 

• Issue a TSTATUS macro to determine certain terminal characteristics, t 



t Parts of this feature do not apply to lAF. 
tt Not applicable to lAF. 
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This conversion mode packs the 8 bits of data as the lower 8 bits of a 12 -bit byte and sets 
the upper bit (bit 11). The exhaustion of the character count or the occurrence of the termi- 
nation code causes the end-of-line condition to be set. A 0007 byte is forced as the first 
byte of input so the data is transmitted as transparent output if it is listed. 

For network terminals, a user selected input prompt should follow the 0006 word if it is 
necessary to guarantee that the terminal is in transparent input mode before input is 
entered. For example, the following two words, when written to an ASCII-code terminal 
output file, switch the terminal to transparent input mode and issue three BEL characters 
at which point transparent input mode is in effect. 

0006 0012 0015 0000 0000 

0007 4007 4007 4007 0000 

Byte 1 of the 0006 word specifies a maximum character count of 10 (I23) and byte 2 speci- 
fies a termination character of carriage return (015 ASCII code). Refer to the description 
of the 0007 control byte for the second word. 

For nonnetwork terminals, any output following the 0006 byte syntax will be discarded. If 
an input prompt is necessary, the program should write it to the terminal before the 0006 
byte. 



NOTE 



The use of transparent input with CYBER Record 
Manager and/or product set members may yield 
unpredictable results. It is advisable to determine 
how a particular product set member treats trans- 
parent input before processing. 



0007 — Initiate Transparent Output 

This byte initiates transparent output. If the user wishes to output data formatted as de- 
scribed for transparent input, a 0007 byte must precede the data. This mode continues until 
an end-of-line or nontransparent output data byte is detected. Termination by an end-of- 
line, however, does not cause a carriage return and line feed. The 0007 byte must be byte 
(bits 59 through 48) of the first word of a line. 

A transparent output data byte is in the format 4xxx octal, where xxx is the 8 -bit octal code | 
for the character being printed. Bits 11 through 8 of a transparent data byte are always set 
to IOOO2. If this pattern is not detected, the terminal is switched to the original (normal 
or ASCII) output mode. Thus, the user can output normal or ASCII data immediately follow- 
ing transparent data without explicitly specifying a termination (end-of-line). The characters 
5, 6, 7, and 8 (display codes 40, 41, 42, and 43 octal) match the transparent mode bit pat- 
tern when in the upper half of a byte and are interpreted as transparent data. Therefore, 
these characters cannot be used to terminate transparent output. Once transparent output 
mode is terminated, it remains cleared unless resumed by a 0007 control byte. 

The following word, when output from an ASCII-code time-sharing terminal, produces a line 
feed and prints a question mark. There is no carriage return or line feed after the question 
mark. 

0007 4012 4077 0000 0000 



tThe NOS Time-Sharing User's Reference Manual refers to this mode as binary output mode. 
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The 4012 byte produces a line feed (012 is the ASCII code for line feed) and 4077 is the 
question mark. The transparent output is terminated by the 24 bits of trailing zeros, con- 
stituting an end-of-line. Similar output can be obtained with the following; 

0007 4012 7100 0000 0000 

Here 71 is the display code for a question mark and 7100 is a nontransparent data byte. 
Transparent output is terminated at the question mark and the end-of-line produces a 
carriage return and line feed. 

A control byte (0003, 0005, 0006) that changes the terminal input mode prevents the 
system from printing a question mark in response to a program request for input. 
However, in all other cases, a read request on the input buffer causes the system to 
print a question mark at the terminal. 



0010 — End-of-Transaction Blockl* 

This byte is used by the transaction subsystem (TAF/TS) to indicate the end of a trans- 
action block. This byte must be followed by an end-of-line. 



0011 — Initiate ASCM Output 

This byte is used to initiate 12 8-character ASCII output (6/12 display code). This byte must 
be byte (bits 59 through 48) and applies only to the line currently being output. 



0012 — End-of-Transaction Block with Responset 

This byte is used by the transaction subsystem to indicate the end of a transaction block 
with a completion response to be sent back to the transaction subsystem. This byte 
must be followed by an end-of-line. 



0013 — End-of-String 

This byte allows a user to terminate a line of output data without repositioning the 
terminal carriage. This byte must be followed by an end-of-line (which is ignored) 
and output continues with subsequent data. The 0013 byte should not be used where 
the effect of an end-of-line is needed (for example, the end of a logical line on a syn- 
chronous terminal). 

0014 — Internal End-of-Block 

This byte is the first byte of a word and is followed by an end-of-line. This byte is 
reserved by NOS and should not be used since it may cause loss of data. 



tNot applicable to network terminals. 
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Phase 



Sequencet 



Effect 



Generating 
output 



Executing 



BREAK 
CTRL T @ 

or 
BREAK 
CTRL P(cR) 



T@ 



CTRL 
or 
CTRL P @ 



If an interrupt address was specified, the pro- 
gram is notified of attempted controL When the 
BREAK key is pressed, output is suspended. 
However, unless CTRL T@ or CTRL P @ is 
entered next, the program is not notified of an 
attempted terminal control. 

If any other sequence is entered, or if just a 
@ is entered, the program is not notified of 
terminal control and the output operation 
continues. 

If an interrupt address was specified, the program 
is notified of attempted control. 



Nonnetwork Terminals 

The following is a list of keys and commands and their effect on other time- sharing terminals. 



I NOTE 



Phase 

Waiting 
for input 



These commands do not apply to network terminals. 
Key/Command Effect 



Generating 
output 



Executing 



STOP @ 

or 
BREAK 



S 

or 
I 

or 
BREAK 

STOP @ 

or 

BREAK 



The user may enter the STOP command at the be- 
ginning of any input line or press the BREAK key 
unless transparent input mode has been selected. | 
STOP is passed to the program as data via the 
input file. If an interrupt address was specified, 
the program is notified of attempted control. 

If an interrupt address was specified, the program 
is notified of attempted control. Output is not ter- 
minated unless the program takes appropriate 
action. 



If an interrupt address was specified, the program 
is notified of attempted control. 



•f The termination (sometimes referred to as user break 2) sequence (that is, CTRL T@) 
and interruption (sometimes referred to as user break 1) sequence (that is, CTRL P@) 
may vary for different terminals. Refer to the lAF Reference Manual for further 
information. 



60445300 M 



2-12-15 



CSET MACRO 

The CSET macro sets the initial and current character set mode of the terminal to 
either ASCII or NORMAL. 

Macro Format: f 



LOCATION 



OPERATION 



CSET 



VARIABLE SUBEIELDS 



arg 



arg, C 



Argument; 
Mode 
ASCII 
NORMAL 
RESTORE 



Description 

Set ASCII 128-character set mode 

Set ASCII graphic 64/ 63- character set mode 

Set current terminal character mode to 
initial terminal character mode 



Change initial and current terminal character mode to that 
specified; if C is omitted, only the current mode is changed. 



NOTE 



The use of this macro may cause the character 
raode of the terminal to switch prior to the print- 
ing of all previous output. This can be prevented 
by preceding the macro call with an input or roll- 
out request. 



PARITY MACRO tt 

The PARITY macro sets the terminal to the indicated parity. 
Macro Format:"^ 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




PARITY 


arg 



arg 



EVEN selects even parity; ODD selects odd parity. 



NOTE 



The use of this macro may cause the parity of 
the terminal to switch prior to all previous out- 
put being printed at the terminal. This can be 
prevented by preceding the macro call with an 
input request. 



•f- This macro is not available in SYSTEXT.' The user must specify systems text PSSTEXT 
or call common deck COMCMAC (refer to appendix A), 
^•f This macro is not applicable to network terminals. Network terminals use terminal 
definition commands to change their parity (the lAF Reference Manual contains a list 
of terminal definition commands). 



2-12-16 



60445300 J 



CPU COMMON DECKS 



...Mil WlU.Mii..l»..,ii mijMMM, :wi,w 



Appendix A lists the CPU common decks of general interest to the COMPASS programmer, 
including a list of those common decks that are available in relocatable form on the system 
library (SYSLIB). The user can obtain documentation of all CPU common decks provided 
with the system OPL by entering the following control statement after accessing the s^'-stem 
OPI.. 

AIODIFY(Z)/-EDlT,CALLCPU 
DOCAIENT. 

In addition, by using the KRONREF utility to determine which common decks are associated 
with which programs, the user can examine the program listings to obtain examples 
of the use of particular common decks. 

Since common decks are continually being changed or updated, it is impossible to maintain 
a complete and current description of each common deck in this appendix, 'f^^'^^ ^i^^ hoqv. 
should consult system listings as described above for specific information. 

COMCMAC 



Thus, the user 



The COMCMAC common deck contains macros (not available in SYSTEXT) for issuing system 
functions for system-oriented programs. The common decks for the processors used must 
also be called by the user. 

The macros defined in common deck COMCMAC are available in systems text PSSTEXT. 
Therefore, the user can access these macros either through the system. OPL or by specifying 
the alternate systems text PSSTEXT. 

The following COMCMAC macros are described in the indicated sections. 



Macro Name 

CATLIST 

CHE C KPT 

CSET 

J3AYFILE 

DISTC 

EDATE 

ENCSF 

ETIME 

EXCST 

GETASL 

GETFLC 

GETFNT 

GETGLS 

GETJA 

GETJCR 



Description 

Catalog user's permanent files 

Create checkpoint dump 

Set terminal character set mode 

Access dayfile 

Disable terminal control 

Edit packed date 

Enter new control statement file 

Edit packed time 

Execute control statement 

Get account block SRU limit 

Read field length control word 

Read FNT/FST entry table 

Get global library set 

Read job accounting words 

Read job control registers 



Section 

5 
10 
12 

9 
12 
11 

4 
11 
10 

6 

6 

4 

6 

6 

6 
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Macro Name Description Section 

GETJN Read job name 6 

GETJO Jlead job origin code 6 

GETJSL Get job step SRU limit 6 

GETLC Get loader control word 6 

GETMC Read machine characteristics 6 

GETPFP Get permanent file parameters 6 

GETPR Read CPU priority 6 

GETQP Read job queue priority 6 

GETSS Get subsystem 6 

GETTL Read job step time limit 6 

LOADD Load fast dynamic load capsule directory 11 

LOADQ Load fast dynamic load capsules 11 

NORERUN Clear rerun status 7 

PARITY Set terminal parity 12 

PRIMARY Make file primary 4 

PROMPT Disable/enable terminal prompt 12 

PSCSF Position control statement file 4 



RERUN Set rerun status 

ROLLOUT Roll out job 

SETGLS Set global library set 

SETJCR Set job control registers 

SETLC Set loader control word 

SETPR Set CPU priority 

SETQP ' Set queue priority 

SETSS Set subsystem 

SETSSM Set secure system memory 

SUBMIT Enter job in input queue 

SUBR Create subroutine tag 

TSTATUS Return terminal status 



7 
6 
6 
6 
6 
6 
6 
6 
6 
7 
11 
12 



COMCCMD 

The COMCCMD common deck contains macros (not available in SYSTEXT) for issuing 
special job control and accounting function requests. 
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The macros defined in common deck COMCCMD are available in systems text PSSTEXT. 
Therefore, the user can access these macros either through the system OPL or by specify- 
ing the alternate text PSSTEXT. 



The following COMCCMD 

Macro Name 
COMMON 
GETACT 

GETEM 

GETJCI 

GETLOF 

MACHID 

MODE 

PACKNAM 

PROTECT 

RECOVR 

REPRIEVE 

SETASL 

SETFET 

SETJCI 

SETJSL 

SETLOF 

SETMFL 

SETRFL 

SETTL 

VERSION 



macros are described in the indicated sections. 

Description 

Change file type to library (LIFT) 

Get outstanding system activity 
information 

Read current exit mode 

Get job control information 

Get list of files pointer 

Read machine identification 

Set exit mode flags 

Request pack name 

Set ECS field length preservation and /or 
user file privacy 

Set recovery processing 

Set reprieve processing 

Set account block SRU limit 

FET modification macro 

Set/clear job control parameters 

Set job step SRU limit 

Set list of files pointer 

Set job maximum field length 

Set job step initial field length 

Set job step time limit 

Read operating system version name 



Section 
4 
6 

6 
6 
6 
6 
6 
6 
6 

10 
10 

6 

2 

6 

6 

6 

6 

6 

6 

6 
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OTHER COMMON DECKS 

The following common decks are also available to the user. 

Common Deck Description 

COMCARGt Processes an argument list by the use of an equivalence table 

COMCARM Processes multiple word arguments 

COMCCDDf Converts a binary integer to display code decimal digits with lead- 

ing zero suppression 

COMCCFDt Converts a 30-bit integer to display code in FORTRAN FIO. 3 

format 

COMCCHD Converts up to a 10-digit decimal number (40 bits) to hexadecimal 

display code with leading zero suppression 

COMCCIOt Performs I/O functions through the PP program CIO 

COMCCODt Converts a binary integer to display code octal digits with leading 

zero suppression 

COMCCPAf Converts positional arguments in an input string to keyword argu- 

ments in an output string 

COMCCPM Calls the PP program CPM to perform tasks involving control 

point activity 

COMCCPTt Copies prefix table comments to a print line 

COMCCVl Contains formulas for converting validation index value to limit 

value 

COMCCVL Common validation interface processor 

COMCDXB| Converts one word of display code digits to a binary value 

COMCECM Contains macro definitions for performing interpretive mode ECS 

reads and writes (refer to appendix D) 

COMCECS Processes interpretive mode ECS read and write instructions 

(refer to appendix D) 

COMCEDT Edits an 18-bit packed date or time into a 10-character display 

coded date or time 

COMCFCE Edits a permanent file catalog entry into a three -line output formula 

COMCHXB Converts one word of hexadecimal display code digits to a binary 

value; leading and trailing blanks are ignored 

COMCLFM Processes requests for the PP program LFM 

COMCLOD User call loader interface 

COMCMTMt Contains macro for generation, allocation, and processing of 

managed tables 



I fThis common deck is also available on the program library (PL) that contains the 
■ common common decks. Contact site personnel for further informationo 
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Common Deck 



Description 



COMCMTPt Contains routines for processing managed tables 

COMCMVEt Moves a block of data 

COMCOVL Requests the PP program LDR to load a specified overlay 

COMCPFM Performs permanent file action functions by calls to the PP 

program PFM 

COMCPOP Obtains parameters from a string buffer 

COMCRDCt Reads one coded line from a CIO buffer to a working buffer 

COMCRDHt Reads one coded line from a CIO buffer to a working buffer with 

trailing space fill 

COMCRDOt Reads one word from a CIO buffer to the X6 register 

COMCRDSt Reads one coded line from a CIO buffer to a working buffer where 

it is stored one character per word 

COMCRDWt Reads the specified number of words from a CIO buffer to a working 

buffer 

COMCRSP Removes secure parameters from control statement 

COMCSFM Processes requests for the PP program SFM 

COMCSFNt Replaces trailing 00 codes with 55 codes in a word 

COMCSNM Sets name in message 

COMCSRTt Identifies the format of a record from the first 64 words located 

in a working buffer 

COMCSSN Skips a sequence number on a coded line if present 

COMCSSTt Sorts a table into ascending order using a shell-sorting technique 

COMCSTFt Determines if a file is, or will be, assigned to a terminal 

COMCSYSt Contains routines for processing system requests 

COMCUPCt Unpacks a control statement to individual parameters 

COMCUSB Unpacks data block to string buffer 

COMCWODt Converts a word to octal display code by an in-line sequence of 

shifts and masks 

COMCWTCt Transfers one coded line in C format from a working buffer to a 

CIO buffer 

COMCWTHt Transfers one coded line in H format from a working buffer to a 

CIO buffer; trailing spaces are deleted 

COMCWTOt Writes one word to a CIO buffer from X6 

COMCWTSt Transfers one coded line from a string buffer to a CIO buffer with 

trailing space suppression 

COMCWTWt Transfers data from a working buffer to a CIO buffer 

COMCZAP Z argument control statement processor 

COMCZTBt Replaces all 00 codes with 55 codes in a word 



I This common deck is also available on the program library (PL) that contains the 
common common decks. Contact site personnel for further information. 
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SYSUB 

The following common decks, unless otherwise noted, are assembled from the PL that con- 
tains the common common decks and are available in relocatable form on the system library 
SYSLIB. 



Common Deck 
COMCGIO 
COMCCPMt 
COMCECSt 
COMCLFMt 
COMCMVE 
COMCOVLt 
COMCPFMt 
COMCRDC 
COMCRDH 
COMCRDO 
COMCRDS 
COMCRDW 
COMCSYS 

COMCWTC 
COMCWTH 
COMCWTO 
COMCWTS 
COMCWTW 



Entry Points 
CIO= 
CPM= 

REC=, WEC= 
LFM= 
MVE= 
OVL= 
PFM= 
RDC = 
RDH= 
RDO= 
RDS = 

LCB = , RDW=, RDX = 
MSG=, RCL=, 
SYS = , WNB = 
WTC = 
WTH= 
WTO= 
WTS = 
DCB = , WTW = . WTX = 



Description 
I/O function processor 
Control point manager processor 
ECS interpretive mode macro processors 
Local file manager processor 
Move block of data 
Overlay load processor 
Permanent file processor 
Read coded line, -C- format 
Read coded line, -H- format 
Read one word 

Read coded line to string buffer 
Read words to working buffer 

Process system request 

Write coded line, -C- format 

Write coded line, -H- format 

Write one word 

Write coded line from string buffer 

Write words from working buffer 



t Assembled from the system OPL. 
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MESSAGES B 
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This appendix contains an alphabetical listing of the messages that may appear in a user's 
dayfile. Lowercase characters are used to identify variable names or fields. All messages 
beginning with variable names or characters follow those beginning with A through Z and 
through 9. These messages are then alphabetized according to the first nonvariable word 
or character. Messages beginning with any special characters (such as hyphens or 
asterisks) are alphabetized as if the special character were not present. For example, the 
message 

pfn ALREADY PERMANENT, AT nnn. 

is listed after the messages beginning with A through Z and through 9 and is alphabetized 
with the messages whose first nonvariable word or character begins with A. 

This appendix contains messages of interest to the applications COMPASS programmer. 
Messages pertaining to general job processing are contained in appendix B of volume 1. 
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CO 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



ACCOUNT BLOCK LIMIT. 



The monitor detected the expiration of the 
account block SRU limit. 



Reset account block SRU 
limit with SETASL control 
statement or macro. If 
the account block limit 
is set at its maximum, 
issue another CHARGE 
statement to begin a 
new account block. 



lAJ 



ADDRESS OUT OF RANGE. 



ALTERNATE IMAGE OBSOLETE. 



An address in a parameter block is outside 
the user's field length. 



The disk space for a file cannot be released 
when the alternate storage image is labeled 
obsolete or the alternate storage address is 
not specified in the permanent file catalog. 



Specify parameter block 
address within field 
length. 

Inform site analyst. 



LFM 



PFM 



ALTERNATE STORAGE ERROR. 



The disk space for a file cannot be released 
when a permanent error status is set for the 
alternate storage file copy. 



Inform site analyst. 



PFM 



ARG. ERROR. 



LDR parameters were outside the user's 
field length. 



Examine program to 
determine error. 



LDR 



ARITHMETIC INDEFINITE. 



The CPU floating-point arithmetic unit 
attempted to use an indefinite operand. 



Analyze the job output 
and dumps to determine 
the cause. 



lAJ 



ARITHMETIC OVERFLOW. 



The CPU floating-point arithmetic unit 
received an operand too large for 
computation. 



Analyze the job output 
and dumps to determine 
the cause. 



lAJ 



ARITHMETIC UNDERFLOW. 



BLANK TAPE, Ifn AT addr. 



The CPU floating-point arithmetic unit 
received an operand too small for 
computation. 

A blank tape was read. (Blank tape is 
defined as more than 25 feet of erased 
tape.) 



Analyze the job output 
and dumps to determine 
the cause. 

Ensure correct tape is 
specified on control 
statement- 



lAJ 



IMT 



BLOCK SEQUENCE ERROR, Ifn AT addr. 



The block length recorded in the file did 
not match the length of the block read, or 
the block number recorded in the file did not 
match the system block count (this message 
applies to I format tapes only) • 



Ensure accuracy of 
format parameter (F) on 
control statement or 
macro. 



IMT 



BLOCK TOO LARGE, Ifn AT addr. 



The tape being read contained a data block 
greater in size than that allowed by the 
specified format or by user declaration. 



Ensure accuracy of 
format parameter (F) on 
control statement or 
macro. 



IMT 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



BOT/EOT ENCOUNTERED, Ifn AT addr. 



BREAKPOINT CONDITION. 



BUFFER ARG. ERROR. 



BUFFER ARGUMENT ERROR, Ifn AT addr. 



Indicates an abnormal tape position. 



The job executed an address for which a 
breakpoint was requested by the system. 

CM address in call is not less than the 
field length minus the word count; buffer 
extends past the job's field length. 



For tape operations, this message indicates 
one of the following. 

- FET less than 7 words long for S/L 
format 

- MLRS greater than 1000 octal for S 
format 

- POSMF Issued and no HDR1 label found in 
FET or extended label buffer 

Refer to volume 2 of the NOS Reference 
Manual . 



Inform site analyst if 
persistent. 

Inform site analyst. 



Verify that operation 
does not reference 
address beyond end of 
buffer or job's field 
length. 

Examine program to 
determine error. 



IMT 



lAJ 



TCS 



IMT 



BUFFER ARGUMENT ERROR ON Ifn AT addr. 



A buffer pointer did not conform to the 
following constraints. 

- FIRST .LE. IN 

- FIRST .LE. OUT 

- OUT .LT. LIMIT .LE. FL 

Refer to volume 2 of the NOS Reference 
Manual . 



Examine program to 
determine error in buffer 
pointers. 



CIO 



BUFFER CONTROL WORD ERROR, Ifn AT addr. 



Either an attempt was made to write a block 
smaller than the noise size on an S, L, or F 
format tape, or a control word error 
occurred in a write (such as bad byte 
count) . Refer to volume 2 of the NOS 
Reference Manual. 



Examine program to 
determine error. 



IMT 



BUFFER CONTROL WORD ERROR ON Ifn AT addr. 



CATALOG OVERFLOW - FILES, AT addr. 



Block length specified on VJRITECW operation 
exceeds the allowable physical record size 
for the device. 



The number of files in the user's catalog 
exceeds his limit. 



Correct the program 
that is formatting the 
data for the miTECW 
operation. 

One or more permanent 
files must be purged in 
order to save or define 
additional files. 



CIO 



PFH 



CATALOG OVERFLOW - SIZE AT addr. 



DO 



The cumulative size of the indirect access 
files in the user's catalog exceeds his 
limit. 



One or more indirect 
access files must be 
purged or shortened to 
allow additional 
permanent file space. 



PFM 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



7 



CHANNEL MALFUNCTION, Ifn AT addr. 
CHECKPOINT nnnn COMPLETE. 



CHECKPOINT nnnn COMPLETED TO filenam. 



CHECKPOINT FILE ERROR. 



CIO ERROR. 



Hardware malfunction. 

Indicates that checkpoint nnnn has 
completed. Issued if only one checkpoint 
file is present. For a checkpoint opera- 
tion, more than two checkpoint files or an 
illegal combination of checkpoint files 
was specified. 

Indicates that checkpoint nnnn has been 
completed to file filenam. Issued if 
alternate CB checkpoint files are used. 

A REQUEST function was issued for more than 
two checkpoint files or a checkpoint mode of 
7 6 octal for an alternate checkpoint file 
was specified. 

Updating of resource file returned error 
status other than end-of-device. 



Inform site analyst. 
None. 



IMT 
CHKPT 



None. 



Correct error and retry. 



Inform site analyst. 



CHKPT 



LFM 



RE SEX 



CKP REQUEST. 

CM BLOCK OUT OF RANGE. 

CM OUT OF RANGE. 



A checkpoint has been initiated. 

Data transfer from ECS specified a CM 
address outside the job field length. 



The program referenced an address outside 
the job CM field length. 



None. 

Analyze the job output 
and dumps to determine 
the cause. 

Analyze job output and 
dumps to determine the 
cause. 



CHKPT 
1AJ 



lAJ 



CM PARITY ERROR. 



CM RANGE EXIT MODE NOT DE SELECTABLE. 



CMC PARITY ERROR. 



Double data parity error (two data bits 
failed) between central memory control (CMC) 
and CM as detected by the single-error 
correction double-error detection (SECDED) 
network, or a single parity error when 
operating in default mode (SECDED network 
disabled) . 

The user attempted to deselect system 
checking for CM out of range errors. This 
cannot be done on a Model 176 system. 



Inform customer 
engineer. 



Determine if the 
program can run with CM 
range error checking. 
If it cannot, the 
program must be 
changed. 



1AJ 



CPM 



The CPU sent the central memory control (CMC) Inform customer 
data or an address having incorrect parity. engineer. 



1AJ 



CONNECT REJECT, Ifn AT addr. 



Unable to connect unit. 



Inform site analyst. 



IMT 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



CONTROLLED BACKSPACE ERROR, Ifn AT addr. 



CPM - ARGUMENT ERROR. 



CPM - ILLEGAL PACKNAM. 



Controlled backspace operation failed 
during write error recovery. Position of 
tape is uncertain. 

Error(s) encountered and job aborted. 



An illegal pack name has been specified. 



Inform customer IMT 

engineer. 

Determine error and rerun CPM 
job step. 

Ensure that legal pack CPM 
name is used . 



CPM - ILLEGAL REQUEST. 



CPM - ILLEGAL USER ACCESS. 



A CPM function was issued without the auto 
recall specified or the job making the 
request was not of system origin. 

The user tried to perform a CPM operation 
for which he is not validated. 



Specify auto recall on CPM 
RA+1 call to CPM or make 
the job system origin. 

None. CPM 



CPU ERROR EXIT AT addr. 



The errors listed after this message 
occurred at address addr, causing job 
termination. 



Refer to the 
descriptions of the 
error messages issued 
with this message. 



1AJ 



CVL CALL ERROR. 



DATA/PERMIT ERRORS, AT addr. 



CVL encountered one of the following errors: 

- Recall bit was not set. 

- Illegal function number was specified. 

- Insufficient or improper combination of 
parameters was specified. 

When loading a file from tape, errors were 
encountered in both data and permit 
information. 



Correct error and rerun 
program. 



Enter CHANGE statement 
or macro with CE 
parameter to allow 
access to the file. 
Make the file local and 
check if data is 
accurate. Do a CATLIST 
to see if the permits 
are accurate. 



CVL 



PFM 



DATA TRANSFER ERROR, AT addr. 



An error occurred in a read operation during 
a file transfer. 



Inform site analyst. 



PFM 



DExx,Ccc,l,sec,ann,Stttt,Aaddr. 



An error has been detected on extended core 
storage. Refer to appendix B of the NOS 
Operator's Guide for further information. 



Inform site analyst. 



6DE 



DEMAND EXCEEDED. 



The user attempted to assign more units than 
were scheduled on the RESOURC statement- 



Increase appropriate 
parameter value on 
RESOURC statement. 



RE SEX 



DEMAND FILE ERROR. 



CO 



Resource execution error was encountered. 
This error occurred because the demand file 
(RSXDid) entry does not match the job name. 



Inform site analyst. 



RE SEX 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



a 



DENSITY CHANGE, TAPE AT nnn- 



DEVICE ERROR ON FILE Ifn AT addr. 



DEVICE UNAVAILABLE, AT addr. 



DIxx,Ccc,l,sec,ann,Stttt,FNqqqq. 

or 
DIxx,Ccc,l,sec,ann,Stttt,Uuu Cyyyy Sttss. 



The tape subsystem detected a change in the 
data recording density on the tape. Error 
is due to a malfunctioning tape unit or a 
bad tape. 



An irrecoverable error occurred on the mass 
storage device containing the file Ifn. 

Access to the permanent file device 
requested is not possible. User may have 
attempted to access files on a device not 
present in the alternate system. 

An error has been detected on mass storage 
device with EST ordinal xx. Refer to 
appendix B of the NOS Operator's Guide for 
further information. 



Ask customer engineer 
to examine the tape 
unit. If tape unit 
does not require 
maintenance, discard 
the tape. 

Inform site analyst. 



Ask the operator to 
make the device 
available. 



Inform site analyst. 



IMT 



CIO 



PFM 



7DI 



DIRECT ACCESS DEVICE ERROR, AT addr. 



DISPLAY DUMP NOT ALLOWED TO TERMINAL. 



DJ... 



DK. .. 



DL... 



The file specified already exists on a 
device other than the device requested or an 
illegal device type was specified. The 
device on which the file resides may not 
contain direct access files because of one 
of the following reasons. 

The device is not specified as a direct 
access device in the catalog descriptor 
table. 

- The device is not specified as ON and 
initialized in the catalog descriptor 
table. 

- The device is a dedicated indirect 
access permanent file device. 

If on an alternate system, the user's master 
device may not have been transferred to that 
system. 

A time-sharing user has attempted to enter 
DMD or DMDECS control statements or DMD or 
DED system requests without assigning file 
OUTPUT to a mass storage device. 

Refer to description of the corresponding 
message beginning with DI or EQ. 

Refer to description of the corresponding 
message beginning with DI or EQ. 

Refer to description of corresponding 
message beginning with DI or EQ. 



Specify correct device 
type. 



PFM 



Assign file OUTPUT to 
mass storage via ASSIGN 
control statement or 
macro and retry. 



CPMEM 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



DM., 



Refer to description of corresponding 
message beginning with DI or EQ. 



DPxx,Ccc,l,sec,ann,Stttt,FNqqqq. 

or 
DPxx,Ccc,l,sec,ann,Stttt,Aaddr,Wwwv7w 
DPxx,Ccc,l,Gggg...g. 
DPxx,Ccc,l,Bbbb. . .b. 

or 
DPxx,Ccc,l,sec,ann,Stttt,Aaddr,Wwv7ww 
DPxx,Ccc,l,ddd...d. 



An error has been detected on distributive Inform site analyst, 

data path (DDP) . Refer to appendix B of the 
NOS Operator's Guide for further 
information. 



6DP 



DQ. 



Refer to description of corresponding 
message beginning with DI or EQ. 



DSP - CAN NOT ROUTE JOB INPUT FILE. 



The job input file cannot be routed. 



Copy job input file to a 
local file to be routed. 



DSP 



DSP - COMPLETE BIT ALREADY SET. 



The complete bit was not cleared before DSP 
was called. 



Clear complete bit 
before calling DSP. 



DSP 



DSP - DEVICE UNAVAILABLE. 



DSP attempted to create a file on a device 
that was turned off or is currently 
unavailable for access. 



Specify different device 
or contact site operator. 



DSP 



DSP - FILE NAME ERROR. 



An attempt was made to create a file with an 
invalid file name. 



Specify valid file name. 



DSP 



DSP - FILE NOT ON MASS STORAGE. 



An attempt was made to route a file not on 
mass storage. 



Copy file to mass 
storage before routing. 



DSP 



DSP - FILE ON REMOVABLE DEVICE. 



A file on a removable device cannot be 
routed. 



Copy file to non- 
removable device before 
routing. 



DSP 



DSP - FNT/DEVICE FULL. 



There is no space in the FNT or on the 
device for current use. 



Retry route at a later 
time. 



DSP 



DSP - FORMS CODE NOT ALPHANUMERIC. 



Forms code must consist of two alphanumeric 
characters. 



Specify alphanumeric 
forms code. 



DSP 



DSP - I/O SEQUENCE ERROR. 



A request was made on a busy file. 



Wait until file is not 
busy. 



DSP 



DSP - ILLEGAL FILE TYPE. 



The file being processed is not a print, 
punch, input, output, or local file type. 
For example, primary and direct access file 
types cannot be processed 



Ensure that file being 
processed is of correct 
type. 



DSP 



DSP - ILLEGAL ORIGIN TYPE. 



DSP cannot route the file to the input queue 
with the origin type specified by the 
caller. 



Specify valid origin 
type. 



DSP 



MESSAGE 



« 



DSP - ILLEGAL REQUEST. 



SIGNIFICANCE 

One of the following. 

- DSP was not called with recall (does 
not apply when queue priority is 
greater thanMXPS). 

- Parameter list address was out of 
range. 

- RA+1 call was formatted 
incorrectly. 



ACTION 

Specify auto recall with 
DSP call or determine why 
parameter list address 
is out of ranee. 



ROUTINE 



DSP 



DSP - ILLEGAL USER CARD. 



User attempted to route a file with an 
illegal USER statement to the input queue. 



Ensure that valid user 
number is being used. 



DSP 



DSP - IMMEDIATE ROUTING - NO FILE. 



The specified file for the immediate routing 
could not be found. 



Ensure that file to be 
routed is available to 
job for processing. 



DSP 



DSP - INVALID DISPOSITION CODE. 



Specified disposition code is not 
recognized. 



Verify disposition code. 



DSP 



DSP - INVALID EXTERNAL CHARACTERISTICS. 



Caller specified an undefined external 
characteristic code. 



Verify external 
characteristic code. 



DSP 



DSP - INVALID JOB ABORT CODE. 



Value of abort code field of DSP parameter 
word four is invalid. 



Verify abort code. 



DSP 



DSP - INVALID SPACING CODE. 



Value specified for spacing code was 
greater than 77 octal. 



Verify spacing code. 



DSP 



DSP - INVALID TID. 



DSP - LOCAL FILE LIMIT. 



One of the following: 

- User number and family name parameters 
were not in CM field length. 

- TID is greater than or equal to IDLM 
for batch jobs. 

- User number specified in parameter 
block does not compare with user number 
in control point area. 

User has exceeded his local file validation 
limits. 



Verify that TID 
parameters are valid. 



Return one or more local 
files to the system. 



DSP 



DSP 



DSP - OUTPUT FILE LIMIT. 



DSP - ROUTE TO INPUT NOT IMMEDIATE. 



Caller. has exceeded his output file 
validation. 



Routing a file to the input queue must be 
immediate. 



If possible, split job 
into two or more jobs 
and retry. Otherwise, 
reduce number of files 
by copying output to 
single file and then 
routing the file. 

Change to immediate 
route. 



DSP 



DSP 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



DSP - THIS ROUTING NOT ALLOWED. 



An attempt was made to change the queue 
type of a deferred routed file. 



DSP - TOO MANY DEFERRED BATCH JOBS. 



DUPLICATE COMMON FILE NAME. 



DUPLICATE FILE NAME. 



DUPLICATED LINES. 



ECS BLOCK OUT OF RANGE. 



The user attempted to submit more deferred 
batch jobs than allowed by his validation 

limit. 



A file of the same name as that specified in 
a COMMON request already exists. 

The file specified already exists in the 
system. 

Duplicate lines being dumped during a DMP 
operation were suppressed. 

Data transfer between CM and ECS specified 
an ECS address outside the job field length. 



Rescind prior routing by 
using the SC disposition 
code with the ROUTE 
control statement or 
macro. ROUTE the file 
again with the desired 
final disposition code. 

Wait for jobs to 
complete or request 
a larger validation 
limit from site 
personnel. 

Use different name in 
request. 

Use different name in 
request. 

None. 



Analyze the job output 
and dumps to determine 
the cause of the error. 



DSP 



DSP 



LFM 



LFM 



CPMEM 



lAJ 



ECS FLAG REGISTER PARITY. 



ECS OUT OF RANGE. 



Parity error detected on ECS flag register 
operation. 

Job referenced ECS address outside job field 
length. 



Inform customer 
engineer. 

Analyze the job output 
and dumps to determine 
the cause of the error. 



lAJ 



lAJ 



END OF SET ILLEGAL REQUEST, Ifn AT addr. 



END OF TAPE, Ifn AT addr. 



**** ENDING SUPPORT OF FILE QUEUInG BY 
*CIO* CLOSE FUNCTIONS (170,174,370). 



A multifile set tape is positioned at end of 
set after a POSMF to a file set that is not 
found. Until the tape is returned or 
repositioned within the multifile set, all 
other operations on this tape are illegal. 

The end-of-tape was encountered. 



CLOSE/RETURN and CLOSE/UNLOAD will not route 
files to the output queue in future versions 
of NOS. 



Return tape via RETURN, 
UNLOAD, or EVICT or 
reposition tape via 
POSMF. 



Ensure that correct file 
manipulation operation 
is specified. 

Change program to use 
the ROUTE macro. 



IMT 



IMT 



CIO 



**** ENDING SUPPORT OF LFM FUNCTION nnB. 



Warning message indicating that functions 
2, 4, 5, 6, 7, 16B, 17B and 30B will not be 
available in future versions of NOS. 



For functions 4, 5, 6, 
7, 16B, and SOB, convert 
the program to use DSP 
to queue the file. 
For function 17B, set 
the id code when 



LFM 



MESSAGE 



**** ENDING SUPPORT OF *OUT* RA+1 REQUEST, 



**** ENDING SUPPORT OF QFM FUNCTION nnB. 



SIGNIFICANCE 



Warning message Indicating that this 
request will not be available in future 
versions of NOS. 

Warning message indicating that functions 
17B and 20B will not be available in future 
versions of NOS. 



ACTION 

queueing the file> 
For function 2, no 
action is possible. 

Convert the program to 
use DSP to queue files. 

For function 17B, 
convert the program to 
use LFM function 15B to 
assign a file to a queue 
device. 



ROUTINE 



OUT 



QFM 



For function 20B, 
convert the program to 
use DSP to queue the 
file. 



**** ENDING SUPPORT OF SFM FUNCTION 13B. 



Warning message indicating that this 
function will not be available in future 
versions of NOS. 



None. 



SFM 



ENTRY POINT NOT FOUND. 



EOI CHANGED BY RECOVERY, AT addr. 



The specified entry point could not be 
found . 

The file was truncated during deadstart 
recovery. 



Verify that entry point 
is valid. 

Use CHANGE statement or 
macro with CE parameter 
to allow access to the 
file. Make the file 
local and list it to 
determine how much of 
the file was lost. 



1AJ 



PFM 



EQxx.DNdn, DIRECT ACCESS FILE ERROR, AT 
addr. 



The system sector data for the file does 
not match the catalog data. Error log and 
dayfile message. 

EQ One of the following equipment 

types. 

DI 844-21 disk (half track) 
DJ 844-41/44 disk (half track) 
DK 844-21 disk (full track) 
DL 844-41/44 disk (full track) 
DM 885 disk (half track) 
DQ 885 disk (full track) 
XX EST ordinal of device 
dn Device number • 



Inform site analyst. 



PFM 



EQxx.DNdn, FILE LENGTH ERROR, AT addr. 



The length of a file does not equal the 
length specified in the catalog. 
EQ Equipment type as defined in 
EQxx,DNdn, DIRECT ACCESS FILE 
ERROR, AT addr. message 
XX EST ordinal of device 



Inform site analyst. 



PFM 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



dn 



Device number 



The cause depends on the type of connnand or 
macro Issued. 
. GET A local file Is created 

with length being the actual 
length retrieved. 
SAVE If file length is longer 

than TRT specification, file 
is truncated. 
REPLACE Same as for SAVE. 



EQxx.DNdn, MASS STORAGE ERROR AT addr. 



An error was encountered in reading a 
portion of the permanent file catalog or 
permit information. Error log and dayflle 
message. 

EQ Equipment type as defined in the 
EQxx.DNdn, DIRECT ACCESS FILE 
ERROR, AT addr. message 
XX EST ordinal of device 
dn Device number 



Inform site analyst* 



PFM 



EQxx,DNdn, RANDOM INDEX ERROR, AT addr. 



The random disk address of the permit 
sector is in error. Error log and dayfile 
message. 

EQ Equipment type as defined in the 
EQxx.DNdn, DIRECT ACCESS FILE 
ERROR, AT addr. message 
XX EST ordinal of device 
dn , Device number 



Inform site analyst* 



PFM 



EQxx,DNdn, REPLACE ERROR, AT addr. 



The same file was found twice during a 
catalog search. This error can occur for 
APPEND or REPLACE commands or macros after a 
file is found and purged and the catalog 
search is continued. Error log and dayfile 
message. 



Retry job step. 



PFM 



EQ 



XX 

dn 



Equipment type as defined in the 
EQxx,DNdn, DIRECT ACCESS FILE 
ERROR, AT addr. message 
EST ordinal of device 
Device number 



EQxx,DNdn, SYSTEM SECTOR ERROR, AT addr. 



W 



The system sector of an indirect access 
permanent file contains an error. Error log 
and dayfile message. 

EQ Equipment type as defined in EQxx, 
DNdn, DIRECT ACCESS FILE ERROR, AT 
addr. message description 
XX EST ordinal of device 
dn Device number 



Inform site analyst. 



PFM 



00 



MESSAGE 



EQxx.DNdn, TRACK LIMIT, AT addr. 



SIGNIFICANCE 



No allocatable tracks remain on equipment 
XX. Error log and day file message. 

EQ Equipment type as defined in the 
EQxx.DNdn, DIRECT ACCESS FILE 
ERROR, AT addr. message 
XX EST ordinal of device 
dn Device number 



ACTION 



Inform site analysts 



ROUTINE 



PFM 



EQxx,FM=family,PF»filenam,UI=userin. 



Additional line is written only in error log 
after one of the following messages. 



None. 



PFM 



EQxx,DNdn, DIRECT ACCESS FILE ERROR, AT addr. 
EQxx,DNdn,FILE LENGTH ERROR, AT addr. 
EQxx,DNdn,MASS STORAGE ERROR, AT addr. 
EQxx,DNdn, RANDOM INDEX ERROR, AT addr. . 
EQxx,DNdn, REPLACE ERROR, AT addr. 
EQxx.Dndn, SYSTEM SECTOR ERROR, AT addr. 
EQxx,DNdn, TRACK LIMIT, AT addr. 



EQ 



XX 

family 
f ilenam 
userin 



Equipment type as defined 

in the EQxx.DNdn, DIRECT 

ACCESS FILE ERROR, AT addr. 

message 

EST ordinal of device 

Family name 

Permanent file name 

User index 



EQUIPMENT NOT AVAILABLE. 



ERASE LIMIT, Ifn AT addr. 



ERROR CODE ec, Ifn AT addr. 



ERROR - FILES (S) NOT PROCESSED. 



ERROR FLAG TERMINATION, Ifn AT addr. 



Tape assignment error was encountered; 
requested equipment is either in use or is 
not defined in the system. 



The system made 20 erasures (10 feet of 
tape) without being able to successfully 
write the tape. 

IMT error code ec has occurred but no 
specific message is issued. This would 
normally not occur unless the job was 
dropped by the operator. 

One or more files were not checkpointed 
because CHKPT detected address errors. 

The job was aborted with a tape operation in 
progress. The operation/request is not 
complete. For example, the operator could 
kill the job while tape error recovery is in 
progress. 



Ensure accuracy of macro 
or control statement 
and/or retry at a later 
time. 

Clean tape or use 
different tape. 



Consult site personnel. 



Determine and correct 
address errors and retry • 

None* 



LFM, 
RESEX 



IMT 



IMT 



CHKPT 



IMT 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



ERROR FLAG TERMINATION, FILE Ifn AT addr. 



The job was aborted with an Input /output 
request in progress. The operation/request 
is not complete. 



None. 



CIO 



ERROR IN PERMIT DATA, Ifn AT addr. 



An error was encountered in the permit 
entries for file Ifn. 



Inform site analysts 



PFM 



ERROR IN ROUTE FUNCTION, LFN-filenam. 



EXCHANGE PACKAGE /MEMORY DUMP ON FILE 
ZZZDUMP. 



FET ADDRESS OUT OF RANGE AT addr. 



Informative message issued to the system 
dayfile stating an error occurred while 
routing filenam. 

The exchange package and memory dunq) is 
written on local file ZZZDUMP because 
the job is of time-sharing origin and file 
OUTPUT is assigned to a terminal. 

FET extends past job's field length. 



Examine the job's 
dayfile for a more 
specific error message. 

To examine the exchange 
package and dump, list 
file ZZZDUMP. 



Verify that FET address 
is valid. 



DSP 



CPMEM 



CIO 



FET PARAMETER ERROR ON Ifn AT addr. 



One of the parameters in the FET is illegal 
or the FET is not long enough for the 
parameter. 



Verify that FET is valid. 



CIO 



FET TOO SHORT. 



FILE BOI/EOI/UI MISMATCH, Ifn AT addr. 



The FET is too short to perform the 
specified function. 

Data in the system sector for file Ifn does 
not match information from the EOI sector 
and/or catalog information. 



Increase length of FET. 



Inform site analyst. 



LFM 



PFM 



FILE BUSY. 



The file specified in the request cannot 
be interlocked. 



Wait until file is 
not busy. 



LFM 



FILE EMPTY. 



FILE ERROR filenam. 



The file specified was en^ty. 



An illegal address was detected on file 
filenam. 



Verify that the file 
contains data and retry. 

Correct error and retry. 



LFM, 
SFM 

CHKPT, 
RESTART 



FILE NAME ERROR. 



File name contains illegal characters or 
contains more than seven characters. 



Ensure that legal file 
name is specified. 



LFM, 

LIBGEN, 

LISTLB 



FILE NAME ERROR, AT addr. 



File name contains illegal characters. 



Verify that file name 
contains only valid 
characters. 



PFM 



FILE NOT DISK RESIDENT. 



Access to a file which does not reside on 
disk is not permitted with the requesting 
function. 



Inform site analyst. 



PFM 



W 



w 



MESSAGE 



FILE NOT FOUND. 



SIGNIFICANCE 



Requested file could not be found. 



ACTION 


ROUTINE 


Verify that file exists 


LFM, 


and retry. 


SFM, 




QFM, 




ENQUIRE, 




STIMULA 



FILE NOT ON MASS STORAGE. 



FILE TOO LONG, AT addr. 



FILE TOO LONG, FILE Ifn AT addr. 



FL BEYOND MFL (ECS). 



FL REQUEST BEYOND MFL (CM). 



FL TOO SHORT FOR PROGRAM. 



FLE TOO SHORT FOR LOAD. 



FNT FULL. 



FORMAT REQUIRES UNLABELED TAPE. 



FUNCTION REJECT, Ifn AT addr. 



FWA .GE. LWA+1. 



The specified file does not reside on mass 
storage. 

The local file specified for a SAVE, REPLACE, 
or APPEND command exceeds the length allowed 
or the direct access file specified for an 
ATTACH operation in WRITE, MODIFY, or APPEND 
mode exceeds the direct access file length 
limit for which the user is validated. 

The length of the direct access permanent 
file currently being written exceeds the 
direct access file length limit for which 
the user is validated. 



ECS field length requirements for the job 
step exceed the ECS field length allowed. 

CM field length requirements for the job 
step exceed the CM field length allowed. 

The user's field length is too short for 
the program. 



An attempt was made to load ECS data beyond 
the user's ECS field length. 

FNT space is currently not available for a 
request that has both the ep and up 
processing options set. 

The format specified (F) is valid only for 
unlabeled tapes. 

Function was rejected (possible hardware 
problem) . 

The first word address parameter was 
greater than the last word address 
parameter on DMP, DMD, DMPECS, DMDECS, LOC, 
or PBC control statements or DMP, DMD, DED, 
or DEP system requests. 



Copy file to mass 
storage and retry. 

Reduce length of file 
or save as a direct 
access file. 



Reduce the length of 
the file or ask site 
personnel for a larger 
direct access file 
length limit. 

Increase job step ECS 
field length. 



lAJ 



PFM 



CIO 



IMA 



Increase job step CM 
field length. 


IMA, 
TCS 


Rerun the job with larger 
field length specifica- 
tion. 


TCS, 
1AJ 


None. 


1AJ, 
LDR 


Retry operation at a 
later time. 


PFM 



The tape must be assigned RESEX 
as an unlabeled tape. 

Inform site analyst. IMT 

Correct error and retry. CPMEM 



^ 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



FWA/LWA .GE. FL. 



Either first word address parameter of LOG 
or the last word address of LOC or PBC was 
greater than or equal to the user's field 
length. 



Reduce FWA and /or LWA 
and retry. 



CPMEM 



GETFNT TABLE TOO LARGE. 



The table generated by the GETFNT function 
exceeds the size specified by the user. 



Specify larger GETFNT 
table size. 



LFM 



HTIME NOT AVAILABLE. 



I/O ON EXECOTEHDNLY FILE Ifn AT addr. 



The HTIME control statement or macro is 
valid only on a CYBER 170 Model 176. 

The user attempted to read, write, or 
position an execute-only file. The only 
operations that may be performed on an 
execute-only file are EVICT, RETURN, REWIND, 
and UNLOAD. 



None. 



Assign file in proper 
mode to allow the 
desired operation. 



lAJ 



CIO 



I/O SEQUENCE ERROR. 



I/O SEQUENCE ERROR, AT addr. 



I/O SEQUENCE ERROR ON FILE Ifn AT addr. 



ILLEGAL CHANGE IN FILE /ORIGIN TYPE. 



ILLEGAL COMMON MEMORY MANAGER REQUEST. 



ILLEGAL DEVICE REQUEST, AT addr. 



ILLEGAL EQUIPMENT. 



Action was requested on a busy file. 



A request was attempted on a local file that 
is currently active. This error can occur, r 
for example, if the user creates two FETs fo 
the same file and issues a second request 
before the first is completed. 

The user attempted to perform more than one 
concurrent function on a single file. 

LFM attempted to change the file/origin type 
of a deferred routed output file. 

Memory request with reserved bits in the 
parameter block were set incorrectly. 

The device type (r parameter) specified on a 
request for an auxiliary device cannot be 
recognized or does not exist in the system. 

If the auxiliary device specified by the pn 
parameter is not the same type as the system 
default, the r parameter must be included; 
if not, the message is issued. 

Equipment specified does not exist or is not 
allowed (for example, a TT device is 
requested from other than terminal origin, 
or a tape is being requested with the 
REQUEST macro). 



Wait until file is not 


CFM, 


busy and retry. 


LFM 


Wait until file is 


PFM, 


inactive. 


LFM 



Wait until each function 
is complete before 
attempting another. 

Rescind prior routing 
(DC=SC option). 

Do not set reserved bits. 



Examine auxiliary 
device request and 
ensure its accuracy. 



CIO 



LFM 



IMA 



PFM 



Ensure file resides on 
a legal equipment type. 



LFM, 
RESEX 



D3 



7 



MESSAGE 
ILLEGAL ERROR EXIT ADDRESS. 

ILLEGAL EXTENSION OF Ifn AT addr. 

ILLEGAL EXTERNAL CALL. 
ILLEGAL FILE MODE. 

ILLEGAL FILE NAME Ifn AT addr. 
ILLEGAL FILE TYPE. 



ILLEGAL I/O REQUEST ON FILE Ifn AT addr. 



ILLEGAL ID CODE. 



ILLEGAL INSTRUCTION. 



ILLEGAL JOB /USER CARDS. 



ILLEGAL LABEL TYPE, Ifn AT addr. 



ILLEGAL LOAD ADDRESS. 



SIGNIFICANCE 

Error exit address is beyond user's current 
field length. 

The user attempted to lengthen a file that 
could not be extended. 

RESEX did not recognize external call. 

The user tried to dispose or unlock a file 
which was in execute-only mode or tried to 
change its file type to library (LIFT). 

The file name does not conform to 
established rules. 

The specified file is of a type not allowed 
in the requested operation. Possible 
causes include attempts to 

- change a nonlocal file to file type 
library 

- designate a direct access file as the 
primary file 

- ROUTE or DISPOSE the primary file 

CIO could not recognize the specified 
function code, or the code was not valid for 
the type of device to which the file was 
assigned. The system provides a dump of the 
FET on file OUTPUT. 

One of the following. 

- An identification code specified on the 
SETID control statement or macro is not 
a valid device identification code as 
defined in the installation EST. 

- An identification code not in the range 
0-67B or 77B is present on the LDI 
control statement. 

The CPU attempted to execute an illegal or 
nonavailable instruction. 



A job was submitted with an invalid job or 
user card. 

Illegal. label type. Only legal label types 
are ANSI labeled and nonstandard labeled. 

The load address is less than 2. 



ACTION 
Informative. 

Verify that valid file 
is being extended. 

Inform site analyst. 

None. 



Use valid file name. 



Verify that file type is 
valid. 



Verify CIO function code 
being used. 



Analyze job output and 
dumps to determine the 
cause of the error. 

Correct job and rerun. 



Use correct label type. 



Specify larger load 
address and retry. 



ROUTINE 
lAJ 

CIO 

RESEX 
LFM 

CIO 
LFM 



CIO 



Reissue the request with LFM 
the correct identi- LDI 

fication code. 



lAJ 



QFM 



IMT 



1AJ 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



ILLEGAL MODIFICATION OF Ifn AT addr. 



ILLEGAL RANDOM ADDRESS. 



ILLEGAL USER ACCESS. 



ILLEGAL USER ACCESS, AT addr. 

ILLEGAL USER ACCESS - CONTACT SITE OPR. 

ILLEGAL USER CARD. 

IMPROPER ACCESSIBILITY. 

INDEX ADDRESS OUT OF RANGE FOR Ifn AT addr. 

INPUT FILE IN NORERUN STATUS. 
INPUT FILE IN RERUN STATUS. 
INSUFFICIENT RESOURCES ON SYSTEM. 



Either the user has attempted to shorten a 
modify-only file or the file cannot be 
modified at all. 

The current random address specified is 
zero. 

The user tried to perform an operation for 
which he is not validated. Possible causes 
include attempts to 

- run a system origin job from nonsystem 
origin 

- access a restricted subsystem without 
proper validation 

- enter an invalid SRU value 

- use the V carriage control character 
without validation 

The user is not validated to create direct 
access or indirect access files or to access 
auxiliary devices. 

The security count for the user number 
specified has been decremented to zero. 
Therefore, the user is denied all access 
to the operating system until the operator 
resets the security count. 

The user attempted to submit a file which 
does not have a USER statement as the 
second statement, has an incorrectly 
formatted USER/ACCOUNT statement, or has an 
invalid family name, user name, or password. 

The user did not specify the correct file 
accessibility on the LABEL statement or 
macro, or volume accessibility was set and 
a nonsystem origin user attempted to assign 
the tape as unlabeled. 

The random sector address for a random 
input/output request was equal to or greater 
than field length. 

Informative message. 

Informative message. 

Resource demand exceeds number of units 
physically available on the system. 



Determine whether file 
can be modified. 



Verify current random 
address. 

Ensure accuracy of 
control statement or 
determine proper vali- 
dation requirements 
via LIMITS statement. 



Contact site personnel 
concerning validations. 



Contact site personnel 
to reestablish access. 



Correct error and rerun. 



Ensure accuracy of 
request. 



CIO 



LFM 



LFM 

MSI 

NETVAL 

QFSP 

RESEX 

IMA 



PFM 



CPM 

NETVAL 
1AJ 
ILS 



QFM 



RESEX 



Correct random sector 


CIO 


address. 




None. 


QFM 


None. 


QFM 


Reduce resource 


RESEX 


demand . 





03 



MESSAGE 



INTERLOCK NOT AVAILABLE. 



INVALID CATALOG UPDATE. 



INVALID PFC ADDRESS. 

JOB CARD ERROR (job statement) 

JOB IN NORERUN STATE ON RECOVERY, 

JOB REPRIEVED. 
JOB STEP LIMIT. 



LABEL CONTENT ERROR, Ifn AT addr. 



LABEL MISSING, Ifn AT addr. 



LABEL NOT EXPIRED. 



LABEL PARAMETER ERROR ON OPEN, Ifn AT addr. 



SIGNIFICANCE 

A software interlock is currently not 
available to the requesting function with 
both ep and up processing options specified. 

Verification of the PFC entry prohibits the 
setting of a new alternate storage address 
when a current alternate storage address 
exists and is not labeled obsolete. Also, 
an existing valid disk address cannot be 
replaced in the PFC entry. 

The device number, track, and sector 
specified as the PFC address are invalid. 

An error was encountered on the job 
statement in the routed or submitted file. 
The first 20 characters of the job 
statement are displayed. 

Identifies a job recovered on level 
deadstart that was aborted because it was 
in a no-rerun mode (due to NORERUN control 
statement or macro) . 

The job has been successfully reprieved. 

The monitor detected the expiration of the 
job step SRU limit. 



A block read was the correct size for a 
label but one or more required fields (such 
as the label name) were incorrect. 

During a read operation, a required label 
was missing. 

The user attempted to write on a tape with 
an unexpired label. 



Label fields did not match on open request. 
An additional message 

FIELD BEGINNING AT addr NO COMPARE, 
specifying the decimal character position in 
HDRl of the first field that did not compare 
correctly is also issued. 



ACTION 

Retry function at a 
later time. 



Inform site analyst. 



ROUTINE 



PFM 



PFM 



Inform site analyst. 



Correct job statement 
and rerun. 



Refer to the NORERUN 
control statement or 
macro. 



None. 

Reset job step limit 
with SETJSL control 
statement or macro and 
retry. If job step SRU 
limit is set at maximum, 
request increased SRU 
validation. 

Use LISTLB control 
statement to obtain 
label data. 

Ensure that tape has 
label. 

If current contents of 
tape can be sacrificed, 
have operator blank 
label tape. Otherwise, 
wait until label has 
expired. 

Use LISTLB control 
statement to obtain 
label data. 



PFM 



DSP 
QFM 



1AJ 



SFP 
lAJ 



IMT 



IMT 



IMT 



IMT 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



LDR ERROR. 



Issued after one of the following errors. 
OVERLAY NOT FOUND IN LIBRARY. 
ARGUMENT ERROR. 



Correct error and retry. 



LDR 



LFM ARG. ERROR. 



LFM ILLEGAL REQUEST. 



LFM detected an error in the request. 



One of the following: 

- The LFM function detected was not 
recognized as a legal function. 

- An LFM function was issued without 
the auto recall bit set. 



Ensure that valid LFM 
request is being made. 

Verify that valid LFM 
request is being used. 



LFM 



LFM 



LIST OF FILES LENGTH TOO LONG. 



LOCAL FILE LIMIT. 



The length of the list of files table is 
greater than the length of the FNT. 

The user has too many local files. 



None. 



Return one or more local 
files and retry. 



CFM 



LFM 
QFM 
IRO 



LOCAL FILE LIMIT, AT addr. 



LOCAL FILE LIMIT, FILE Ifn AT addr. 



M.T. NOT AVAILABLE ON FILE Ifn AT addr. 



MAGNET NOT ACTIVE. 



MESSAGE LIMIT. 



MFL LESS THAN ECS MINIMUM CM FL. 



The job's local file limit has been exceeded 
in an attempt to GET or ATTACH the file. 

The job's local file limit was exceeded in 
an attempt to define another file or attach 
an existing file to the job. 

The magnetic tape executive is not 
executing. 

No UDT address or incorrect UDT address in 
FST or MAGNET not present. 

The number of messages the job issued 
has exceeded the limit for which the user 
is validated. Message functions issued by 
compilers or applications programs that 
run at the user's job control point are 
also counted as user dayfile messages and 
thus are subject to the user's validated 
dayfile message limit. 

To use ECS the user must have a required 
minimum amount of CM FL. This message 
indicates user does not have the required 
CM FL. 



Return one or more local 
files. 

Return one or more local 
files. 



Inform site operator. 



Inform site analyst. 



Split job into two or 
more jobs and retry. 



Increase CM FL. 



PFM 



CIO 



CIO 



LFM 
RESEX 

lAJ 
IMA 



IMA 



f 



MISSING DEMAND FILE ENTRY. 



Dayfile message indicating RESEX internal 
problem. The overcommitment algorithm was 
initiated without a demand file entry having 
been defined previously. 



Inform site analyst. 



RESEX 



? 



MESSAGE 
MISSING VSN OR EQUIPMENT ASSIGNMENT. 

MONITOR CALL ERROR. 

MT,Ccc,Eec,Hhhhhhhhh,B.C.RESTART. 
MT,Ccc,Eec,Hhhhhhhhh,BAD ERASE. 
MT,Ccc,Eec,Hhhhhhhhh,BID RECOVERY -x. 

MT,Ccc,Eec,Hhhhhhhhh, BLOCK TOO LARGE. 

MT,Ccc,Eec,Hhhhhhhhh,BUSY. 
MT,Ccc,Eec,Hhhhhhhhh, CHANNEL ILL. 

MT,Ccc,Eec,Hhhhhhhhh,CON.REJ. 

MT,Ccc,Eec,Hhhhhhhhh,CON REJ. MDI. 

MT,Ccc,Eec,Hhhhhhhhh,CON.REJ.OFF. 
MT.Ccc.Eee.Hhhhhhhhh, DENSITY CHANGE. 



MT , Cc c , Eec , Hhhhhhhhh , FNf f , Pyyyy . 



MT,Ccc,Eec,Hhhhhhhhh,Lbbbb,Bnnnnnn. 



SIGNIFICANCE 

Dayfile message indicating internal 
malfunction in RESEX (expected VSN or 
equipment assignment was not found) . 

RA+1 call unrecognized. 



Magnetic tape controller controlware 
restarted. 

Error detected after an erase was attempted 
to recover a write error. 

A single block mispositioning error was 
recovered by block ID recovery. If x is B, 
the error was caused by backspacing the tape 
too far; if x is F, the tape was not 
backspaced far enough. 

Data block is at least one byte longer 
than length bbbb shown in third line of 
message. 

Unit was still busy after 1 second. 

Channel is not accepting function for status 
requests properly. 

Connect reject; unable to connect to the 
unit. 

Connect reject; unable to connect to unit 
because of marginal detection indication 
(thermal warning). Unit turned off. 

Connect reject; unable to connect to unit. 
Unit turned off. 

The tape subsystem detected a change in the 
data recording density on the tape. Error 
is due to a malfunctioning tape unit or a 
bad tape. 



Function ff was rejected by the controller; 
yyyy is the address in IMT where the 
function was initiated. 

The length (bbbb) and block number (nnnnnn) 
read from trailer bytes in block did not 
match the actual length or the block number 
read; given in previous message line. 



ACTION ROUTINE 



Inform site analyst. RESEX 



Examine program to lAJ 

determine why illegal 
RA+1 call is being made. 

None. IMT 



Inform site analyst. IMT 



None. IMT 



None. IMT 

Inform customer engineer. IMT 

Inform customer engineer. IMT 

Inform site analyst. IMT 



Inform customer IMT 

engineer. 



Inform site analyst. IMT 



Ask customer engineer IMT 

to examine the tape 

unit. If tape unit 

does not require 

maintenance, discard 

the tape. 

Inform site analyst. IMT 



None. IMT 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



MT,Ccc,Eec,Hhhhhhhhh,LOAD CHECK. 



MT,Ccc,Eec,Hhhhhhhhh, MARGINAL DOWN. 



MT,Ccc,Eec,Hhhhhhhhh, MARGINAL OFF. 



MT,Ccc,Eec,Hhhhhhhhh,NO EOF. 

MT,Ccc,Eec,Hhhhhhhhh, NOISE. 
MT,Ccc,Eec,Hhhhhhhhh,NOT READY. 
MT,Ccc,Eec,Hhhhhhhhh,ON THE FLY. 
MT,Ccc,Eec,Hhhhhhhhh, POSITION LOST. 

MT,Ccc,Eec,Hhhhhhhhh, RECOVERED. 

MT,Ccc,Eec,Hhhhhhhhh, STATUS. 

MT,Ccc,Eec,Hhhhhhhhh, WRONG PARITY. 



MT,Ccc-e-uu,vsn,rw,xx,Ss,GSgggggggg. 

MT,Ccc,Dddd...d. 

MT,Ccc,Uuu. . .u.Ttttt. 

MT,Ccc,Ff f ,Iii,Bnnnnnn,Lbbbb,Ppppppppp. 

MT,Ccc,Eec,Hhhhhhhhh,type. 

or 
MT,Ccc-e-uu,vsn,rw,xx,Ss,GSgggggggg. 
MT,Ccc,Dddd...d. 

MT,Ccc,Fff,Iii, Bnnnnnn , Lbbbb , Ppppppppp . 
MT,Ccc,Eec,Hhhhhhhhh,type. 



DO 



Load sequence failed on the unit. 



Indicates controller failure. Channel has 
been logically turned off and maintenance 
is required. 

Unit has been logically turned off because 
of read/write failure. This occurred when 
a special function to check the read/write 
path to a unit failed during initial label 
scan. Maintenance is required. 

No end-of-operation detected from unit 
within 1 second. 

A noise block was skipped on the tape. 

Tape unit dropped ready status. 

Error was corrected as the data was read. 

The last good block written cannot be found 
during write recovery. 

Previously reported error has been 
successfully recovered. 

Error type cannot be determined so actual 
controller status is returned. 

Tape was written in parity opposite that 
being read. 

Four or five-line message describing a 
magnetic tape hardware malfunction on a 66x 
or 67x tape unit. Message as illustrated 
indicates 7-track, model 667 or 677 unit. 
If NT appears in place of MT, message 
indicates 9-track, model 669 or 679 unit. 
Message is issued to error log and dayfile. 

The first line of each message provides the 
following information. 

cc-e-uu Channel, equipment (tape 

controller) , and physical unit 
number of tape unit on which 
error was encountered. 

vsn Volume serial number associated 
with tape on the specified unit. 

rw Read (RD) or write (WR) 



Push CLEAR button and 
reload tape or contact 
site analyst. 

Inform customer 
engineer. 



Inform customer 
engineer. 



Inform customer engineer • 

None. 

Make unit ready. 

None. 

None. 

None. 

Inform site analyst. 

None. 



Refer to the 
separate listing of 
the last line message 
(MT, ....type.) for the 
appropriate action. 



IMT 



IMT 



IMT 



IMT 

IMT 
IMT 
IMT 
IMT 

IMT 

IMT 

IMT 

IMT 



MESSAGE 



CO 



gggggggg 



SIGNIFICANCE 

operation; any operation not 

involving an actual read or 

write is listed as a read. 

EST ordinal of the unit on which 

the tape was written. This is 

provided only for labeled tapes 

generated under NOS; otherwise, 

the field is blank. 

Channel status. 

General status of magnetic tape 

unit. Last byte is block ID. 



ACTION 



ROUTINE 



The MT,Ccc,Dddd...d line of the message 
provides the following information. 

cc Channel number; the channel 

number is repeated to allow the 
analyst to associate this message 
with the first message if errors 
are occurring on more than one 
tape channel at the same time. 

ddd...d Detailed status of magnetic tape 
unit. 

The MT.Ccc.Uuu. ..u,Ttttt line of the message 
provides the following information. 

cc Channel number; repeated to 

associate this message with the 
previous messages. 

UU...U Unit status of the magnetic tape 
unit. 

tttt Third byte of the tape unit 

format parameters (refer to the 
magnetic tape subsystem 
reference manual for 
descriptions of unit format 
parameter fields) . 

The MT,Ccc,Fff ,...,Ppppppppp line of the 
message provides the following information. 



cc Channel number; repeated to 

associate this message with the 

previous messages, 
f f Software function on which the 

error occurred, 
ii Error iteration; number of times 

error has been encountered on 

this unit without successful 

recovery, 
nnnnnn Block number on which error 

occurred, 
bbbb Length of block on which error 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



occurred in octal bytes, 
pppppppp IMT internal error parameters. 

The last line of each message provides the 
following information. 



MT/NT CONFLICT. 



MULTI-FILE NAME NOT FOUND Ifn AT addr. 



MULTI-FILE NOT FOUND, Ifn AT addr. 



NO ECS. 



ec 
hhhhhhhh 



type 



Channel number; repeated to 
associate this message with the 
previous messages. 
Octal error code value. 
Parameters passed to the tape 
unit for the format function 
(refer to the tape drive's 
hardware reference manual for 
descriptions of the unit format 
parameter fields) . 
Additional description of the 
error. Refer to individual 
listing of the last line message- 



Conflict exists between 7-track and 9-track 
tape descriptors (track type, density, and 
conversion mode). For example, a request 
for a 9-track tape specified 200-bpi 
density. 

This message can also be issued if the 
device type specified in FET+1 conflicts 
with the track type specified in FET+8, bit 
56. If dt=MT and bit 56 is set, the 
message is issued. 

User issued a POSMF on a nonexistent file 
or a nontape file. 

Either LISTLB has reached the end of the 
multifile set or the requested file was not 
found. The following additional messages 
are also given. 

REQUESTED SECTION xxxx. 

FOUND SECTION yyyy. 
or 

FILE IDENTIFIER NOT FOUND. 
The Ifn, addr, xxxx, and yyyy given can be 
ignored . 



A DMPECS or DMDECS control statement or DED 
or DEP request was entered and no ECS field 
length is assigned to the user. 



Ensure accuracy of 
control statement. 



RE SEX 

BLANK 



Verify file name. 



If LISTLB reached the 
end of the multifile 
set, the operation is 
complete and no action 
is required. Otherwise, 
ensure that the correct 
tape is being used and 
that it contains the 
desired file(s) . All 
label parameters must 
match in order to 
position to the 
specified file. 

None. 



CIO 



IMT 



CPMEM 



a 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTIlffi 



GO 



NO INPUT FILE FOUND. 



NO MASS STORAGE AVAILABLE. 



No valid input file exists; functions cannot 
be performed. 

User attempted to reserve a track for a null 
primary file. 



Verify that input file 
is valid. 

Retry later. 



QFM 



LFM 



NO WRITE ENABLE, ON Ifn AT ad dr. 



NON-MATCHING CONVERSION. 



Either the user attempted to write on a tape 
mounted with no write ring or no write was 
allowed because of additional constraints 
described in an additional message line- 



Informative message indicating conversion 
mode on labeled 9-track tape differs from 
that specified by assignment request. 
System writes tape in specified mode, or 
reads tape with write ring out in correct 
mode. However, reading tape with write ring 
in or using wrong conversion mode generates 
conversion errors. 



If no additional IMT 

message line appears 
ensure the inserting of 
a write ring by 
specifying the W 
processing option on the 
tape request (for 
example, PO=W on the 
LABEL control statement) . 
Otherwise, refer to the 
description of the mes- 
sage in the additional 
message line. 

If reading tape with RESEX 

write ring in, return 

and reassign with 

correct conversion 

mode. 



NON-MATCHING DENSITY. 



NORERUN /RERUN IGNORED FROM TTY JOBS. 



Informative message indicating that the None. 

density specified on the control statement 

or macro is not the same as the density of 

the assigned tape. Issued only to 9-track 

tapes with write ring out. 9-track tapes 

are read at the current density on tape. 

They are written at specified density if 

write initiated from load point; otherwise, 

tape is written at the current density on 

the tape. 

User entered NORERUN or RERUN from a None, 

terminal. The command is ignored. 



RESEX 



QFM 
CONTROL 



NT.... 



Refer to description of MT. 
messages. 



. series of 



OPERATOR DROP. 



Informative message 
indicating that the 
operator dropped the job. 



None. 



DSD 
1AJ 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



OPERATOR EVICT. 



The operator entered an EVICT command to 
drop the job from the rollout queue. This 
disallows EXIT, EREXIT, and REPRIEVE 
processing. 



Contact site operator to 
determine the cause of 
job eviction. 



IRI 



OPERATOR KILL. 



The operator entered a KILL command to drop 
the job. This disallows EREXIT processing. 
A job with extended REPRIEVE processing is 
reprieved once. EXIT processing is allowed. 



Correct job as needed 
and rerun. 



lAJ 



OPERATOR OVERRIDE. 



The operator entered an OVERRIDE command to 
drop the job. This disallows EXIT, EREXIT, 
and REPRIEVE processing. 



Correct job as needed 
and rerun. 



lAJ 



OUTPUT FILE LIMIT. 



The total number of files disposed to the 
output queue by the job has exceeded the 
limit for which the user is validated. 



If possible, split job 
into two or more jobs 
and retry. Otherwise, 
reduce number of files 
by copying output to 
single file and then 
issuing dispose. 



LFM 



OUTPUT FILE LIMIT, FILE Ifn AT addr. 



During an attempt to close this file, the 
number of files disposed to output queues by 
the job has exceeded the limit for which the 
user is validated. 



If possible, split job 
into two or more jobs and 
retry. Otherwise, reduce 
number of files by 
copying output to single 
file and then issuing 
dispose. 



CIO 



OVERLAY FILE EMPTY. 



No data appears in the requested file. 



Verify that overlay 
file is valid. 



lAJ 



OVERLAY FILE NOT FOUND. 



The specified file was not available. 



Verify that file is 
local to job and retry. 



lAJ 



OVERLAY LOST. 



The specified overlay was not found. 



Verify that file with 
specified overlay is 
local to job. 



1AJ 



OVERLAY NOT FOUND IN LIBRARY - ovlname. 



The overlay ovlnam was not found in the 
system library. 



Verify that call is to 
valid overlay. 



LDR 



PARAMETER BLOCK BUSY. 



The completion bit of the parameter block 
was not set to one before the RA+1 request 
was made. 



Set completion bit 
before making RA+1 
call. 



LFM 



PF STAGING DISABLED, AT addr. 



ca 



The specified direct access file resides on 
the Mass Storage Facility (MSF) and the site 
has temporarily disabled all MSF file 
staging. 



Ask site operator when 
MSF file staging will 
resume and retry the 
job at that time. 



PFM 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



CO 



PF UTILITY ACTIVE, AT addr. 



PFC VERIFICATION ERROR. 



Because a permanent file utility is 
currently active, the operation was not 
attempted; the user should retry 
the operation. 

The creation date and time, user index, or 
alternate storage address do not agree with 
the current PFC contents. 



Wait until PF utility is 
not active and retry. 



Inform site analyst. 



PFM 



PFM 



PFM ARGUMENT ERROR. 



PFM detected an error in the request. 



Ensure that a valid PFM 
request is being made. 



PFM 



PFM EXCESS ACTIVITY. 



The system PFM activity count is currently 
at its limit. This condition is reported 
to the requesting program only if both 
ep and up processing options are set. 



Retry operation later. 



PFM 



PFM ILLEGAL REQUEST. 



One of the following occurred: 

- A privileged command was requested by a 
nonvalidated program. 

- An illegal backup requirement, preferred 
residence, or subsystem value was entered. 



Verify that the PFM 
request is valid. 



PFM 



PFM ILLEGAL REQUEST, AT addr. 



One of the following: 

- Illegal command code passed to PFM. 

- Illegal permit mode or catalog type 
specified. 

- CATLIST request has permit specified 
without a file name. 

- PERMIT command or macro attempted on 
public file. 



Verify that PFM request 
is valid. 



PFM 



PFM INVALID FAMILY. 



The family and device specified are not 
active on the system. 



Inform site analyst. 



PFM 



POSITION ERROR ON-filenam. 



File filenam was not repositioned after 
being checkpointed because CHKPT detected 
an address error. 



None. 



CHKPT 



POSITION LOST, Ifn AT addr. 



During write or read error recovery, the 
system could not find the last good block of 
data, making it impossible to successfully 
perform error recovery. Labels are not 
written after this error and existing data 
on the tape is not destroyed. 



Retry operation on 
different tape and/or 
tape drive, if possible. 



IMT 



PP CALL ERROR. 



PRIOR TAPE ASSIGNMENT LOST. 



The monitor detected an error in a CPU 
request for PP action. 

Magnetic tape executive has been dropped 
along with tapes assigned. All of the 
user's prior tape assignments are lost. 



Verify that correct PP 
call is issued. 

Terminal user must 
return/unload all 
prior tapes and 
reassign. Batch user 
is aborted and must 



1AJ 



RESEX 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



PROGRAM NOT FOUND. 



PROGRAM NOT ON MASS STORAGE. 



PROGRAM STOP. 



The program to be loaded was not found on 
the specified library file. 

The program does not reside on a mass 
storage device. 

The system processed a program stop (00) 
instruction. 



rerun his job. 

Verify that the program EXU 
is on library file. 

Copy program to mass EXU 

storage. 

None. lAJ 



PROGRAM STOP AT addr. 



The monitor detected a program stop 
instruction at address addr. 



None. 



1AJ 



PROGRAM TOO LONG. 



PROTECTED FILE. 



PRU LIMIT, AT addr. 



The program does not fit in the available 
storage. 

The user has attempted to release a locked 
file. 

The job's mass storage PRU limit was 
exceeded during preparation of a local copy 
of an indirect access file. 



Increase field length and 
retry. 

None. 



Return one or more local 
files and retry. 



EXU 



LFM 



PFM 



PRU LIMIT, FILE Ifn AT addr. 



The job's mass stoage PRU limit was exceeded 
during an attempt to write or extend this 

file. 



Return one or more local 
files and retry. 



CIO 



PRUS REQUESTED UNAVAILABLE, AT addr. 



QFM ARGUMENT ERROR. 



QFM - BUFFER ARGUMENT ERROR. 



The number of PRUs specified via the S 
parameter on the DEFINE request is not 
available. 

One of the following: 

- Address is outside field length. 

- Address is equal to 1 . 

- Origin code is out of range. 

- ID code is out of range. 

A buffer pointer did not conform to the 
following constraints. 

FIRST .LE. IN 

FIRST .LE. OUT 

OUT .LE. LIMIT .LE. FL 



Request smaller number of 
PRUs. 



Verify that QFM request 
is valid. 



Examine program to 
determine error in 
buffer pointers. 



PFM 



QFM 



QFM 



00 



QFM FILE EMPTY. 



Either an empty file was specified on a 
READ directive in the submit source file or 
the NR parameter was specified on the SUBMIT 
statement so that the specified file was not 
rewound . 



Check that the correct 
file is specified. If 
it is, rewind the file 
or remove the NR 
parameter from the 
SUBMIT statement. 



QFM 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



DO 



QFM FILE NAME ERROR. 
QFM FILE NOT FOUND. 

QFM FILE NOT ON MASS STORAGE. 

QFM I/O SEQUENCE ERROR. 
QFM ILLEGAL EQUIPMENT. 

QFM ILLEGAL FILE TYPE. 
QFM ILLEGAL ID CODE. 
QFM ILLEGAL ORIGIN TYPE. 
QFM ILLEGAL REQUEST. 



QFM ILLEGAL USER ACCESS. 



QFM INVAID FNT ADDRESS. 



RANDOM ADDRESS NOT ON FILE Ifn AT addr. 



READ AFTER WRITE, ifn AT addr. 



The ifn specified is not a valid file name. 
The file to be submitted could not be found. 

The file to be submitted does not reside on 
mass storage. 

Action was requested on a busy file. 



The equipment specified in FET+7 either is 
not mass storage or is not in the range of 
the EST. 

The file to be submitted is not a local 
file type. 

The ID code is out of range. 



The origin type for the file to be submitted 
is not local or remote batch. 

One of the following. 

- Specified function was illegal or 
undefined 

- Job did not have SSJ= entry point 

- Auto recall bit was not set 

The user tried to perform an operation for 
which he is not validated (for example, 
attempting to run a system origin job from 
nonsystem origin. 



The FNT address of the file to be attached 
is out of range. 



The random address specified was not within 
the bounds of the file. The system provides 
a dump of the FET on file OUTPUT. 

The user attempted to read a tape on which 
the last operation was a write. 



Verify file name. QFM 

Verify that submit QFM 

file exists. 

Copy file to be QFM 

submitted to mass 
storage and retry. 

Wait until file is not QFM 
busy and retry. 

Verify that correct QFM 

equipment is specified in 

FET+7. 

Copy the submit file to QFM 
a local file. 

Verify that valid ID code QFM 
is being used. 

Verify that origin type QFM 
is correct. 

Verify that valid QFM QFM 
request is being made. 



Ensure accuracy of QFM 

control statement or 

macro or determine 

proper validation 

requirements. 

Ensure that the routine QFM 
calling QFM supplies the 
correct address. 



Verify that random 
address is correct. 



Ensure accuracy of tape 
positioning statements 
(BKSP, BKSPRU, SKIPFB, 
or REWIND required to 
read after write) . 



CIO 



IMT 



MESSAGE 
READY DROP, Ifn AT addr. 
REPRIEVE BLOCK ERROR. 



REPRIEVE CHECKSUM BAD. 



REQUEST UNDEFINED ON DEVICE ifn AT addr. 



RERUN NOT POSSIBLE. 



SIGNIFICANCE 

Unit dropped ready. 

An address is out of range or there is an 
illegal parameter in the reprieve parameter 
block at the time of an error. The message 
is also issued if the specified reprieve 
address itself is out of range. (1AJ issues 
this message for all errors except terminal 
interrupts processed by IRI.) 

The computed checksum does not agree with 
the checksum specified in the parameter 
block at the time of the error. (1AJ issues 
this message for all errors except terminal 
interrupts processed by IRI.) 



The specified function cannot be performed 
on the device on which the file resides. The 
system provides a dump of the FET on file 
OUTPUT. 

The job cannot be rerun because of one of 
the following. 

- Job is time-sharing origin. 

- No input file is found for the job. 

- An error occurred in reading or 
writing the input file system sector. 

- Rerun status is disabled. 



ACTION 


ROUTINE 


None. 


IMT 


Ensure parameter block 


lAJ 


is correct. 


IRI 



Ensure interrupt 
handler is still 
intact. Ensure that 
code in the area for 
which checksum was 
computed has not 
changed . 

Verify that valid 
device is specified. 



None. 



lAJ 
IRI 



CIO 



IDS 



RESEX ABORT - OPERATOR TERMINATION. 



RESEX ABORT - SYSTEM RESOURCE LIMIT. 



RESEX ABORT - TERMINAL INTERRUPT. 



The operator entered a DROP, KILL or 
RERUN command, setting an error flag in 
RESEX. RESEX performed appropriate cleanup 
procedures before termination. 

RESEX terminated prematurely due to job 
time limit, SRU limit, or track limit. 
RESEX performs appropriate cleanup proce- 
dures before termination. 



Terminal user interrupted RESEX (interrupt 
or terminate sequence) . RESEX performs 
appropriate cleanup procedures before 
termination. 



Determine reason for 
operator action. Rerun 
job, if desired. 



If error caused by 
SRU or time limit, 
increase resource 
limits. If caused 
by track limit, con- 
tact site analyst. 

None. 



RESEX 



RESEX 



RESEX 



RESEX DETECTED ERROR. 



The resource executive (RESEX) detected an 
error. 



Inform site analyst. 



LFM 



D3 



MESSAGE 



ta 



RESEX FAILURE, AT addr. 



SIGNIFICANCE 

The resource executive (RESEX) has detected 
a fatal error. 



ACTION 



Inform site analyst. 



ROUTINE 



PFM 



RESOURCE ENVIRONMENT ERROR. 



RESOURCE NEGATIVE SHARE COUNT. 



RESOURCE PF ERROR ec filenam. 



Dayfile message indicating RESEX internal 
problem occurred (internal environment 
building failed due to MST, UDT, or EST 
errors) . 

Dayfile message indicating RESEX internal 
problem occurred. The resource overcommit- 
ment algorithm indicates a greater number of 
users are supposedly sharing a removable 
pack than are actually sharing the pack. 

PFM error ec occurred when attaching 
resource file filenam. 



Inform site analyst. 



Inform site analyst. 



Inform site analyst. 



RESEX 



RESEX 



RESEX 



RESOURCE SCRATCH FILE ERROR. 



Dayfile message Indicating RESEX internal 
problem has occurred. An empty entry has 
been found in the overcommitment algorithm 
scratch file. 



Inform site analyst. 



RESEX 



RFL BEYOND MFL. 



The RFL request is greater than the maximum 
field length for a job step. 



Increase maximum field 
length with MFL 
statement. 



CPM 



ROLLIN FILE BAD. 



A job could not be rolled in correctly. 



Inform site analyst. 
Check error log dayfile 
for the job that was 
aborted and the location 
of the bad rollin file. 



IRI 



RPV-ADDRESS OUT OF RANGE. 



An address provided to RPV was out of range. 
This includes one of the following. 

- FWA of parameter block .GE. FL 

- LWA of parameter block .GE. FL 

- Transfer address .GE. FL 

- Transfer address .LT. 2. 



Check to see that no 
portion of the parameter 
block or an address 
specified is beyond the 
user's field length. 



RPV 



RPV-CALLED WITHOUT AUTO-RECALL. 



An extended RPV mode call was made without 
auto-recall. 



Ensure that auto-recall 
bit is set. 



RPV 



RPV-ILLEGAL CALL. 



One of the following is true. 

- An attempt was made to do a reset when 
no previous error existed or the 
previous error had been pending. 

- An extended mode call was attempted when 
RPV non-extended or DISTC had 

already been set in the control point 
area. 

- A non-extended mode call was attempted 
when RPV extended mode had already been 
set in the control point area. 



Check to see if a 
reset is allowed. 
If RPV non-extended 
mode has already 
been used, then RPV 
non-extended mode 
cannot be used in 
the same job. 
If RPV extended 
mode has already 
been used, then RPV 
non-extended mode 



RPV 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



RPV-ILLEGAL FUNCTION CODE. 



The function code specified in the 
parameter block was illegal. 



cannot be used in 
the same job. 

Function code in 
parameter block must 
equal 1 for setup, 2 
for resume, or 3 for 
reset. 



RPV 



RPV-ILLEGAL PENDING INTERRUPT. 



A bit was set in the pending interrupt word 
of the parameter block which did not 
correspond to a defined error. 



Check parameter block 
to ensure that all bits 
set correspond to a 
defined error. 



RPV 



RPV-ILLEGAL PENDING RA+1 REQUEST. 



RPV-LWA OF CHECKSUM .LT. FWA. 



RPV-PARAMETER BLOCK TOO SHORT. 



The pending RA+1 request field of the 
parameter block contained an invalid RA+1 
request on a RESUME or SETUP. On a RESET, 
the pending RA+1 request is not validated 
since the job will not be restarted. 

The last word address of the checksum was 
less than the first word address. 

The length specified in the parameter block 
was less than 31 words. 



Check pending RA+1 
request word in 
parameter block to 
ensure that it contains 
a valid call. 

Correct and rerun. 



Ensure that the length 
specified in the 
parameter block is 
greater than or equal 
to 31B. 



RPV 



RPV 



RPV 



RPV-UNDEFINED MASK. 



The mask specified in the parameter block 
is not a legal mask. 



Check mask set in 
parameter block to 
ensure that it is a 
valid mark. 



RPV 



SECURE MEMORY, DUMP DISABLED. 



SFM ARGUMENT ERROR. 



The user attempted to dump memory protected 
by the system, or entered DMD or DMP after a 
CCL statement or from a terminal. 



The argument passed to SFM was out of bounds 
or the FET specified did not specify a 
buffer of at least 100 octal words. 



Refer to Security lAJ 

Control in section 3 and 
the DMD and DMP 
statements in the NOS 
Reference Manual, volume 
1 . To obtain memory 
dumps from a time- 
sharing job, include the 
DMD or DMP statement in 
a procedure or in an 
ENTER statement. A DMD 
statement can be 
included only in a batch 
job. 

Verify that SFM SFM 

request is valid. 



MESSAGE 



DO 



SFM DAYFILE BUSY. 

SFM ILLEGAL DAYFILE CODE. 

SFM ILLEGAL REQUEST. 

SFM TRACK INTERLOCK ERROR. 

SFM UNABLE TO INTERLOCK DEVICE. 
SI CODED FORMAT ILLEGAL. 

SL NOT VALIDATED. 

STATUS ERROR, Ifn AT addr. 



SIGNIFICANCE 



Action was requested on a busy dayflle. 

The dayflle code passed in the FET was not 
within range. 

The requested function or origin type 
specified in the function call was not 
recognizable or SFM request was made and the 
auto recall bit was not set. 

Track was either interlocked when it should 
not have been or not interlocked when it 
should have been. 

SFM request was not performed because the 
selected device could not be interlocked. 

An atten^t was made to perform a read or 
write operation on an SI tape with the 
coded bit set in the FET. 



The SRU limit requested exceeds that for 
which the user is validated. 

An irrecoverable error was encountered. A 
second message line describes the error in 
more detail. 

ARA BURST First block of tape at 
DEFECTIVE. 1600 or 6250 cpi cannot be 
read or written. Another 
unit or tape should be 
tried. 



CRC ERROR. 



FILL STATUS 
ILLEGAL. 



MULTI-TRACK 
PHASE ERROR. 



PARITY ERROR. 



An error was detected in 
cyclic redundancy character. 

The system has detected an 
odd number of frame, a 
condition which is illegal 
for the data format of the 
tape being read. 

Multiple tracks were found 
to be in error at 1600 cpi, 
making recovery impossible. 

The tape could not be 
read/written correctly. 



ACTION 

Inform site analyst. 
Inform site analyst. 



Verify that SFM 
request is valid. 



Inform site analyst. 



Inform site analyst. 



Resubmit the job with 
binary specified for 
the operation on the 
SI tape. 

Request smaller SRU 
limit. 

Retry or inform site 
analyst. 



ROUTINE 

SFM 
SFM 

SFM 

SFM 
SFM 



1MT 



CPM 



IMT 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



UNIT HAS MOTION 
PROBLEMS . 



UNIT PROBLEMS. 



POSTAMBLE 
ERROR. 



SINGLE FRAME 
ERROR. 



The tape unit cannot 
properly write the tape. 
The user should resubmit 
his job, using a different 
tape unit. 

Unit check bit is set in 
detailed status (67x units 
only) . The user should 
try another unit. 

A missing or defective 
postamble was detected at 
1600 cpi. 

A frame (NRZI only) 
containing all zeros was 
read; data will be at least 
one frame short. 



STEP CONDITION. 



SUBSYSTEM ABORTED. 



SYSTEM ABORT. 



LRC ERROR. 



ILLEGAL 
CHARACTER. 



The longitudinal redundancy 
check character was read 
incorrectly (9-track NRZI) . 

Illegal character read from 
9-track tape. If a 1 is 
detected in bit 6 of a 
translated character, the 
character Is illegal. 



Step mode flag set in the PSD register 
caused the program to interrupt at the end 
of a program instruction with an exchange 
jump to EEA (the error exit address in the 
exchange package). 

The user job was connected (either long 
term connection or wait response set) to a 
subsystem which aborted. 

Possible causes include the following. 

- Invalid USER statement 

- Attempt to access a restricted subsystem 

- Operator evicted job 

- Unrecognizable error flag 

- SSJ= block outside field length 

- 1RI detected a bad rollout file 

IRO detected an unrecoverable ECS parity 
error during rollout of a job's ECS 
field length. 



Inform site analyst* 



Retry later< 



If the cause was an 
invalid USER statement 
or an attempt to access 
a restricted subsystem, 
correct the job and 
rerun. Otherwise, 
contact a site analyst* 



lAJ 



lAJ 



lAJ 



DO 



MESSAGE 



CO 



SIGNIFICANCE 



ACTION 



ROUTINE 



SYSTEM CHECKPOINT ABORT. 



SYSTEM ERROR. 



The checkpoint system was up and aborted, 
and in the process aborted a number of 
subsystems. 

One of the following. 

- RESEX cannot communicate wtih subsystem 
via the RSB or SIC monitor calls. 

- LFM cannot complete the requested LFM 
function because the calling program has 
a DMP= entry point. 

- BLANK is unable to read low core 
pointers via the RSB monitor call. 

- PFM detects error condition. 



Informative message. 



Inform site analyst. 



1CK 



BLANK, 
LFM, 
PFM, 
RESEX 



TAPE FORMAT PROBABLY WRONG. 



This message is issued in addition to one of 
the following messages. 

BLOCK SEQUENCE ERROR, Ifn AT addr. 

BLOCK TOO LARGE, Ifn AT addr. 

WRONG PARITY, Ifn AT addr. 



Ensure accuracy of 
format (F) parameter on 
control statement or 
macro. 



1MT 



TIME LIMIT. 



TL NOT VALIDATED. 



The execution time limit for a job step 
expired resulting in job termination. 



The time limit requested exceeds that for 
which the user is validated. 



If a time limit was set 
for the job, include a 
SETTL statement 
requesting a longer 
time limit for the job 
step. If the job step 
time limit was the 
maximum for which the 
user is validated, 
request a larger time 
limit or decrease the 
amount of processing to 
be performed by the job 
step. 

Request smaller time 
limit. 



1AJ 



CPM, 
ACCFAM 



TOO MANY DEFERRED BATCH JOBS. 



TOTAL ASSIGNED COUNT ERROR. 



The user is not validated for this function 
or he has more jobs in the system than he 
is allowed. (All jobs in local and remote 
batch queues are counted.) The count is 
ignored if the job is of system origin or 
the user is validated for system privileges 
and DEBUG mode is set by the operator. 

Dayfile message indicating RESEX internal 
problem (sum of individual resource assigned 
counts differs from total assigned count in 
demand file entry). 



Resubmit the job when QFM 
a queued deferred batch 
job has been processed. 

To change your valida- 
tion limit, contact 
site personnel. 

Inform site analyst. RESEX 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



TOTAL DEMAND COUNT ERROR. 

TRACK LIMIT, FILE Ifn AT addr. 

UNIDENTIFIED PROGRAM FORMAT. 

UNIT HUNG UP ON EOP OR BUSY, ifn AT addr. 
VEJ - BUFFER ARGUMENT ERROR. 



VEJ - ILLEGAL REQUEST. 



VSN FILE ERROR. 



WRITE ON READ-ONLY FILE Ifn AT addr. 



WRITE OVER LABEL. 



WRITE OVER LABEL ILLEGAL ON ifn AT addr. 



WRONG PARITY, Ifn AT addr. 



CO 



Dayfile message indicating RESEX internal 
problem occurred (sum of individual resource 
demand counts differs from total demand 
count in demand file entry). 

The device on which the file resides is full. 



The file the user requested to be loaded 
was in an unrecognizable format. 

Unit did not receive EOP on unit busy. 

Dayfile message indicating that FET buffer 
pointers are invalid. (FWA<LWA<FL) or TID 
(terminal id) with complement address was 
not within the field length. 



Dayfile message indicating that one of the 
following conditions has occurred. 

- VEJ was called by a control point 
which did not have priority greater 
than MXPS. 

- The FET address was out of range. 

- A job without SSJ= privileges 
attempted to specify a system sector 
address in the RA+1 call. 

- The system sector buffer was not 
within the field length. 

- A nonmass storage device request was 

made. 

Dayfle message indicating RESEX internal 
problem occurred (VSN file entry does not 
match job identification). 

Either the user attempted to write on a file 
with write interlock or the direct access 
file was not attached in WRITE mode. 

The user attempted to write over the VOLl 
label. 

The user is not allowed to destroy the VOLl 
label. 



A 7-track tape is being read in opposite 
parity from which it was written. 



Inform site analyst. RESEX 



Specify another device CIO 
or contact site analyst. 

Check the format of the lAJ 
file. 

Inform site analyst. 1MT 

If issued to a subsystem VEJ 
(such as BATCHIO or RBF) , 
inform site analyst 
immediately to determine 
which condition caused 
the error. 



If issued to a subsystem 
(such as BATCHIO or RBF), 
inform site analyst 
immediately to determine 
which condition caused 
the error. 



VEJ 



Inform site analyst. 



Reattach file in write 
mode or clear write 
interlock. 

Have the operator blank 
label the tape. 

Use LISTLB control 
statement to obtain 
label data. 

Ensure accuracy of 
format parameter (F) on 
control statement or 
macro. 



RESEX 



CIO, 

lAFEX, 

TELEX 

IMT 



IMT 



IMT 



(33 



MESSAGE 



XL BUFFER/FET PARAMETER ERROR, Ifn AT addr. 



200BPI WRITE ILLEGAL. 



fllenam ALREADY PERMANENT, AT addr. 



SIGNIFICANCE 

One of the following: 

- HDRl label in extended label buffer or 
FET contains a nonnumeric display code 
value in a numeric field. 

- Character count in header word preceding 
labels in the extended label buffer does 
not equal 80. 

The tape unit (667 or 677) cannot record 
data at 200 bpi. 

The user has already saved or defined a file 
with the name specified. 



ACTION 

Correct condition that 
caused error and retry. 



ROUTINE 



IMT 



Specify a different 
tape density. 

Save or define file using 
different file name or 
purge existing file. 



IMT 



PFM 



jobnam ASSIGNS EXCEED DEMANDS. 



Dayfile message indicating that RESEX 
internal problems occurred. The resources 
actually assigned to the job jobnam exceed 
the resources demanded on a RESOURC state- 
ment. 



Inform site analyst. 



RESEX 



pfn BUSY, AT addr. 



The specified direct access file is 
attached in an incompatible mode, or it is 
currently being accessed by one of the 
following. 

- More than 77B users in READ mode 

- More than 77B users in READAP mode 

- More than 7777B users in READMD mode 



Reissue ATTACH until file 
becomes available, or 
issue ATTACH specifying 
NA option. 



PFM 



Ifn EMPTY, AT addr. 



The file specified on a SAVE request 
contains no data. 



Verify that file contains 
data and retry. 



PFM 



pfn ILLEGAL FILE TYPE, AT addr. 



pfn INTERLOCKED. 



The operation requested cannot be performed 
on the specified file because it is of the 
wrong file type. This message is issued 
when the user attempts to define a direct 
access file with the same name as a file 
currently assigned to the job that is of a 
file type other than local (LOFT) . 

The file is currently not available for 
write, modify, or append modes of access 
because a system utility has attached the 
file in utility mode. 



Define the file using a 
unique name or return 
the conflicting file. 



Retry operation later. 



PFM 



PFM 



pfn IS DIRECT ACCESS, AT addr. 



An indirect access file operation was 
attempted on a direct access file. 



Use the appropriate 
direct access file 
request. 



PFM 



pfn IS INDIRECT ACCESS, AT addr. 



A direct access file operation was 
attempted on an indirect access file. 



Use the appropriate 
indirect access file 
request. 



PFM 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



jobnam MISSING RESOURCE. 



fllenam NOT FOUND, AT addr. 

or 
un NOT FOUND, AT addr. 



Dayfile message Indicating that RESEX inter- 
nal problem occurred. RESEX expected but did 
not find a resource unit assigned to the 
specified job. This could occur if MAGNET 
was stopped while tapes were assigned. 

One of the following. 

- The specified permanent file could 
not be found. 

- The specified user number could not 
be found. 

- The user is not allowed to access the 
specified file. 

- The specified local file could not be 
found or was an execute-only file. 



Inform site analyst. 



Verify that file name/ 
user number is correct, 
that access permission 
has been granted, and 
that correct access is 
being attempted. 



RESEX 



PFM 



filenam NOT ON MASS STORAGE, AT addr. 



The file to be saved is not on mass storage; 
the first track of the file is not 
recognizable. 



Verify that file is on 
mass storage. 



PFM 



pfn PERMANENT ERROR, AT addr. 



The specified direct access file resides on 
the Mass Storage Facility (MSF) and has data 
errors that cannot be corrected. 



Ask site analyst about 
file recovery from a 
backup copy. 



PFM 



jobnam SHARE TABLE MISMATCH. 



pfn STAGE INITIATED. 



Dayfile message indicating that RESEX inter- 
nal problem occurred. While processing the 
specified job, an expected share table 
entry match with the environment did not 
occur. 

The file does not reside on disk. It is 
currently being staged from alternate 
storage to disk. 



Inform site analyst. 



Wait until stage 
operation is complete. 



RESEX 



PFM 



pfn WAITING MSS EXEC 



The file must be staged from alternate 
storage to disk and the MSS executive is not 
currently available to perform the stage 
operation. MSS archive processing is 
enabled. 



Wait for executive to 
be started or inform 
site analyst. 



PFM 



00 



GLOSSARY 
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Abort 

Absolute Assembly 

Account Block 
AUocatable Device 

Alphanumeric 
Alternate User Number 

ANSI 

ASCII 
Auto Recall 

Auxiliary Device 
Block 



BOI 
Buffer 



To terminate a program or job when a condition 
(hardware or software) exists from which the program 
or computer cannot recover. 

In the context of this manual, a COMPASS program 
assembled with the ABS pseudo instruction in which 
there are no references to external entry points. 

An accumulation of SRUs that are applied to a job or 
a charge and project number. 

A storage device that can be shared by more than one 
job and which is allocated by the system without 
operator intervention. 

Consisting of alphabetic and/or numeric characters 
only. 

A user number specified in a permanent file request 
which indicates the action is to be taken on an alter- 
nate user's permanent file. 

American National Standards Institute. An organiza- 
tion that establishes standards for the benefit of its 
member organizations. 

American National Standard Code for Information 
Interchange character set. 

The act of a program releasing control of the CPU 
until a requested function is complete. Refer also to 
recall. 

A mass storage permanent file device used to supple- 
ment storage provided by the normal permanent file 
devices associated with the system (refer to family 
device). 

The information between interrecord gaps on a mag- 
netic tape. Blocking is the grouping of user records 
for efficiency in transfer between memory and 
storage devices. Block size is specified with the 
LABEL macro. 

Beginning- of- information. 

An intermediate storage area used to compensate for 
a difference in rates of data flow, or times of event 
occurrence, when transmitting data between central 
memory and an external device during input/output 
operations. 
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Byte 



Capsule 



Central Memory 



A 12-bit portion of a 60-bit central memory word 
(refer to word) starting in bit position 59, 47. 35, 23, 
or 11. Bytes are numbered to 4 from the left. 

A relocatable collection of one or more programs 
bound together in a special format that allows the 
programs to be loaded and unloaded dynamically from 
an executing program by the Fast Dynamic Loader. 

The main device for storing instructions and data in 
a computer system. Individual storage cells (called 
words) can be addressed by a computer program and 
the contents of those storage cells can be loaded 
directly into registers where instructions can be 
executed and data can be operated on. 

Central memory is composed of from 49000 to 
262000 words, each 60 bits in length. 



Checkpoint 



Checksum 
Circular Buffer 



Common Deck 



Compare/ Move Unit 



COMPASS 
Control Byte 
Control Points 



The process of writing to a magnetic tape or mass 
storage file a copy of the user's central memory, the 
system information used for job control, and the 
names and contents of all assigned files that are identi- 
fied in a CHECKPT macro request (refer to section iO). 

A numeric value used to verify a file. 

A temporary central memory storage area that con- 
tains data during input/output operations. Routines 
that process I/O treat the first word of the buffer area 
as contiguous to the last word of the buffer area. 
Refer to section 2. 

A common deck is a subprogram or group of macro 
or symbol definitions that are accessed from a program 
library using the CALL Modify directive or XTEXT 
COMPASS pseudo instruction. 

The Compare /Move Unit (CMU) provides CPU instruc- 
tions for moving and comparing data fields that 
consist of strings of 6-bit characters. Refer to the 
SYSCOM macro in section 1 for information on deter- 
mining if the CMU is available. 

The assembly language of the CYBER 170, CYBER 70, 
and 6000 Series computers. 

A 12 -bit byte that changes the current input or output 
mode at a time-sharing terminal (refer to section 12). 

The concept which enables the multiprogramming 
capability of NOS. When a job is assigned to a control 
point, that job is allocated a portion of central memory 
and it becomes eligible for assignment to the central 
processor for execution. 
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Control Statement Record 



CPU 



CYBER Loader 



CYBER Record Manager 



Dayfile 



A text record that contains control statement images. 
The first, and possibly only, record on the job input 
file consisting of statement images that start with 
a job statement and end with the first EOii or EOF 
or the EOI. 

Central processor unit. The high-speed arithmetic 
unit that performs the addition, subtraction, multi- 
plication, division, incrementing, logical operations, 
and branching instructions needed to execute programs. 

The NOS product that prepares programs for execution 
by placing program instruction and data blocks in 
central memory. 

A software product supported under NOS that allows 
the user to create and read a variety of record types, 
blocking types, and file organizations to be created 
and read. The execution time input/output of COBOL 
4, COBOL 5, FORTRAN 4, FORTRAN 5. Sort/Merge 
4. ALGOL 5. BASIC, and the DMS-170 products is 
implemented through CYBER Record Manager. 
COMPASS programs can use either CYBER Record 
Manager or CIO. 

A chronological system file which forms an accounting 
and job history file. Entries, called dayfile messages, 
are generated by operator action, user actions, or by 
the system. The system dayfile has entries for the 
entire system. Every job receives a user dayfile 
with entries pertinent io that job. 



Default 

Device Type Code 

Direct Access File 

Display Code 
Disposition Code 

ECS 



A system-supplied parameter value or name used 
when a value or name is not supplied by the user. 

A 12 -bit display code field indicating the type of device I 
upon which a file resides. ■ 

A permanent file that can be attached to the user's job 
with the ATTACH macro. All changes to this file are 
made on the file itself rather than a working copy of 
the file (refer to indirect access file). 

A 6-bLt code used to represent alphanumeric and 
special characters (refer to appendix A in volume 1). 

A two-character mnemonic indicating destination 
queue and format for processing a file named on a 
ROUTE macro. 

Extended core storage. An additional memory avail- 
able as an option. This memory can only be used for 
program and data storage, not for program execution. 
Special hardware instructions exist for transferring 
data between central memory and ECS. 
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Empty Record 
End-of-line 

Entry Point 

EOF 

EOI 



A PRU that contains no user data (refer to zero length 
PRU). 

A separator in coded files that is represented by 12 
bits of zero, right-justified in a 60-bit word. In some 
cases, up to 66 trailing zero bits are considered an 
end-of-line. 

A symbolic name within a program that can be 
referenced from other programs. Each entry point 
has a unique program location with which it is 
associated. 

End-of-file is a boundary within a sequential file, but 
not necessarily the end of a file that can be referenced 
by name. The actual end of a named file is defined by 
EOI. 

End-of-information. The physical end of data. On 
mass storage devices, the position of the last written 
data. For magnetic tapes, refer to appendix J. 



EOR 



EOT 

Equipment Code 
EST Ordinal 

Exchange Jump 



End-of- record is the terminator of a logical record. 
On a PRU device, a short PRU or a zero length PRU 
with a level designator of indicates EOR. On tapes 
that are not PRU devices, an interrecord gap indicates 
EOR. 

End-of-tape; metallic strip marking the end of the 
recordable portion of a magnetic tape. 

Refer to Device Type Code. 

The number designating the position of an entry within 
the equipment status table established at each 
installation. 

Execution of a CPU program is initiated by an ex- 
change jump. The program is defined by the contents 
of the exchange package area before the exchange jump 
took place. For the program to execute, the proper 
contents of its operational registers must be loaded 
into the CPU. These contents are what is contained 
in the exchange package area associated with the 
program. 
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Exchange Package 



Exit Mode 



Extended Labeled Processing 



External Reference 



Family Device 



Fast Dynamic Loader (FDL) 



FET 



Field Lengtii (FL,FLE) 



File 



File Category 



A 16 -word table containing information used in ex- 
change jumps during job execution: contents of central 
processor registers, RA and FL in central memory 
and in ECS and the program address. It is stored in 
the control point area and can be printed as part of 
the output of a central memory dump (refer to the 
DMP control statement). Refer to the REPRIEVE 
macro, section 10, and DISTC macro in section 12. 

A flag set by the MODE macro that specifies the types 
of errors that cause the CPU to abort. 

A tape processing mode in which all tape labels 
(including optional labels) are read into a label buffer 
for further processing. 

A reference in a program to an entry point in another 
program. 

Mass storage permanent file device associated with 
a specific system. A family may consist of 1 to 63 
logical devices. Normally, a system runs with one 
family of permanent file devices available. However, 
additional families may be introduced during normal 
operation. This enables the user associated with the 
additional families to access their permanent files via 
an alternate system. 

A facility that provides fast loading and unloading of 
specially formatted code called capsules. The amount 
of memory required for job execution can be greatly 
reduced because capsules can be easily loaded and 
unloaded as needed, freeing memory for other uses. 

File environment table. It defines the current status 
and properties of a file that is being used by a job. 

FL is the number of central memory words assigned 
to a job. FLE is the number of words of extended 
core storage assigned to a job. Within central 
memory or extended core storage, the field length 
added to the reference address defines the upper 
address limit of a job. 

Set of information that begins at BOX and ends at EOI 
and that is referred to by a logical file name. A file 
is also defined as that portion of a file terminated by 
EOF; thus, a multifile file can exist. All files are at 
least one PRU in length. 

A permanent file attribute that specifies the manner 
in which alternate users can access the file (refer to 
section 5). 
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File Environment Table 
File Flushing 

File Set 



File Types 



Flag 



FNT 



Frame 



FST 



Full Track 



Function Processor 



Refer to FET. 

The process of writing the contents of a file's circular 
buffer to mass storage when certain conditions are 
met (refer to SETLOF macro in section 6). 

One or more tape files referred to by the Ifn on a 
tape assignment statement. A file set may consist of: 

• One file recorded on a single volume. 

• More than one file recorded on a single 
volume. 

• One file recorded on more than one volume. 

• More than one file recorded on more than 
one volume. 

To conform to the ANSI tape standard, all files 
within a file set must have the same setid in their 
HDRl labels. 

NOS defines several file types that are used to control 
job processing. The file type is defined in the FNT 
(refer to appendix E for a list of file types and the 
GETFNT macro in section 4 for information on 
determining file types). 

A character or bit that signals the occurrence or 
presence of a particular condition. 

File name table. The first word of the two-word 
FNT/FST entry which contains the local file name, 
the file type and other job control information (refer 
to the GETFNT macro in section 4). 

A tape recording unit made up of 1 bit from each 
tape track (7 bits for seven-track tape; 9 bits for 
nine-track tape). Each frame usually represents one 
character. 

File status table. The second word of the two-word 
FNT/FST entry which contains information pertaining 
to the file's location on mass storage and other job 
control information. 

Reading/writing sequential sectors on an 844 or 885 
disk pack. 

A system CPU or PP program that the user can call 
by placing a request in location RA+1. Function 
processors perform input/output, local and permanent 
file manipulations, and so on. 
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Generation 

Global Library Set 

Half Track 
Indirect Access F'ile 

Input File Type 
Interactive Progranns 

Interrecord Gap 
Interrupt 



Job Step 



Label 



Level Designator 



Level Number 



The position of a file within a series of files, each 
file developed from the preceding file. The 
generation number and generation version number of 
a tape file can be entered in its HDRl label. 

An ordered set of libraries that remain in effect 
throughout job execution unless specifically changed 
(refer to SETGLS macro in section 6). 

Reading/writing alternate sectors on an 844 or 885 
disk pack. 

A permanent file that is accessed only by making a 
working copy of the file (GET macro). It is created 
or altered by saving or replacing the contents of an 
existing working file (REPLACE or SAVE macros). 

Job file. Its first record is a control statement 
record which may be followed by records containing 
data, directives, or programs used by job steps. 

CPU programs in which the user and the computer 
communicate with each other, rather than the user 
submitting his job, receiving output, and having no 
control over the job while processing occurs. 

Space skipped between the writing of data blocks on 
magnetic tape. 

To stop a running program in such a way that it can 
be resumed at a later time. Also a special control 
signal which, when issued from a terminal, causes | 

action as described by the program. Refer to the 
REPRIEVE macro in section 10 and the DISTC macro 
in section 12. 

Each individual control statement or loader sequence 

is a job step. A group of job steps forms a job stream, _ 

control statement record, or a procedure file. I 

A block at the beginning or end of a magnetic tape 
volume or file, which serves to identify and /or 
delimit that volume or file. Refer to the LABEL 
macro in section 4 and appendix G in volume 1 for a 
description of labels. 

The level designator is an octal number in the termi- 
nating marker of a PRU, ranging from 00 to ITg. A 
level 17 in an empty PRU designates an EOF. A level 
in a short PRU designates an EOR. A level 1 in a 
short PRU designates an EOR and that the record 
came from an interactive terminal. A level 16 in a 
short PRU designates an EOR on a checkpoint file. 
The level designator is returned to the FET on a I 

READ. ■ 

Refer to level designator. 
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Ifn 



Library 



Library File 

Line 

List of Files 

Load Point 

Local File 

Local File Name 
Locked File 

Logical Record 



Local file name. The file name assigned to any file 
while it is local (assigned) to a job. The name is 
contained in the FNT. 

A file or collection of files containing executable 
programs and tables needed to locate and load the 
programs. A system library can contain peripheral 
processor programs in addition to central processor 
programs. A user library is file formatted as a 
library but is not available to a job until it has been 
explicitly declared via CYBER loader control state- 
ments or macros. 

A read-only file that can be accessed by several users 
simultaneously. 

Refer to zero byte terminator and end-of-line. 

A table containing names of files that are to be con- 
sidered for file flushing (refer to SETLOF macro in 
section 6). 

Metallic strip marking the beginning of the recordable 
portion of a magnetic tape. 

A file that is currently associated with a job. Each 
local file has an FNT/FST entry. 

Refer to Ifn. 

A file on which a user cannot write. Refer to LOCK 
macro in section 4. 

A logical record on mass storage is terminated by 
an EOR; on tape, it is terminated by the conditions 
described in appendix J for individual tape formats. 



Macro 



mlrs 



Multifile File 

Multifile Set 
Network 

Network Terminal 



A sequence of source statements that are saved and 
then assembled whenever needed through a macro call. 

Maximum logical record size. A number that speci- 
fies the maximum size for a logical record for S and 
L tape formats. 

A file containing more than one logical file. It begins 
at BOI and ends at EOI. On a labeled tape, a multi- 
file file is delimited by corresponding HDRl and 
EOFl labels. 

A tape file set having more than one tape file. 

A sophisticated data and message switching and 
routing system used to provide communication between 
terminals and applications. 

A terminal that communicates with the operating 
system through the network. 
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Nonallocatable Device 



Nonstandard Tape Label 



opdef 



OPL 



Overlay- 



Pack Name 



Parameter 



Parity 



Password 



Permanent File 



A device such as a magnetic tape which can be used by 
only one job at a given time. 

A tape label format that cannot be read or written by 
the system. If the tape is at load point, a subsequent 
read operation skips to the first tape mark. 

A sequence of source statements that are saved and 
then assembled whenever needed through an opdef 
call. Differs from a macro in that the assembler 
interprets the call by examining the format or syntax 
of the instruction rather than the contents of the 
operation field alone. 

Old program library. In this manual it refers to the 
Modify-formatted program library that contains source 
code for system routines and common decks. 

One or more relocatable programs that were relocated 
and linked together into a single absolute program. 
It can be amain, primary, or secondary overlay. 

A one- to seven-character name that identifies the 
auxiliary device to be accessed in a permanent file 
request (refer to section 5). 

A variable that is given a specific value for a 
particular purpose or process. 

In writing data on tape, an extra bit is either set or 
cleared in each byte so that every byte has either an 
odd number of set bits (odd parity) or an even number 
of set bits (even parity). Nine-track tapes are always 
written in odd parity. For seven-track tapes, a coded 
write is in even parity and a binary write is in odd 
parity. Parity is checked on a read for error detec- 
tion and possible recovery. 

A file access word that defines access to a particular 
file by alternate users. 

A mass storage file cataloged by the system so that 
its location and identification are always known to the 
system. Permanent files are protected by the system 
from unauthorized access according to privacy controls 
specified when they are created, and will be maintained 
until the user deletes them. 



Permanent File Catalog 



Permanent File Family 



A 16 -word entry that the system maintains and uses 
to determine attributes of a permanent file. 

Permanent files which reside on the family devices of 
a specific system. 
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Physical Record 



PP 



Primary File 



Print File 



Private Auxiliary Device 



Program Library 



PRU 



On magnetic tape, information between interrecord 
gaps (refer to block). It need not contain a fixed 
amount of data. For mass storage, refer to PRU. 

Peripheral processor. An individual computer with 
its own memory, used for high-speed transfer of 
information (input and output) between peripheral 
devices and central memory. 

The primary file is the default file for several control 
statements and time sharing commands. It is re- 
wound before each job step. 

Output file containing data to be printed. Printing 
occurs at job completion or upon execution of a 
ROUTE or RELEASE macro. 

Auxiliary device associated with a specific user. Only 
the user may create files on the device, although he 
may permit other users to access files which reside 
on the device. 

The file generated by Modify that contains the decks 
of line images. Line images in the program library 
are in a format that can be manipulated by Modify. 

Physical record unit. The amount of information 
transmitted by a single physical operation of a 
specified device. A PRU for mass storage devices 
is 64 central memory words in length. A PRU for 
a magnetic tape is described in appendix J. 



PRU Device 



Pseudo Instruction 



Public Auxiliary Device 

Punch File 
Qualified Symbol 



A magnetic tape file or a m^ass storage device in which 
information has a physical structure governed by 
physical record units (PRUs). 

An assembler-defined instruction appearing in the 
operation field of a statement. It normally does not 
specify the assembly of a single machine instruction, 
but instead specifies some other assembly process 
(such as symbol definition and listing control). 

Auxiliary device available for access by all validated 
users knowing the correct pack name. Additional 
validation is required to create or replace files on an 
auxiliary device. 

Output file containing data to be punched on cards. 

A symbol defined when a qualifier is in effect during 
assembly. Through qualification, the same symbol 
can be referred to in different subprograms without 
conflict. 
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Queue Priority 



Random Access 



Random File 



Recall 



Record 

Record Separator 

Reel 

Reference Address (RA and RAE) 



Register 



Relative Address 



A number that controls the scheduling of a job to and 
from the rollout queue relative to other jobs of the 
same origin type (refer to SETQP macro in section 6). 

Access method by which any record in a file can be 
accessed at any time. Applies only to mass storage 
files with an organization other than sequential. 

A file with an index entry to each record in the file. 
A file on a rotating mass storage device is a random 
file only when the random bit is set in the file environ- 
ment table. The last record of the file is an index. 

The state of a program when it has released control 
of the central processor until a fixed time has 
elapsed (periodic recall) or until a requested function 
is completed (auto recall). Recall is a system action 
request as well as an optional parameter of some file 
action requests. 

Refer to logical record. 

Refer to EOR. 

Refer to volume. 

RA is the absolute central memory address that is 
the starting or zero relative address assigned to a 
program. Addresses within the program are relative 
to RA. RA+1 is used as the communication word 
between the user program and the system. RAE is 
the absolute extended core storage starting address 
assigned to a program. 

A unit within the CPU used to hold operands. The A 
registers contain the addresses of words within 
central memory, the X registers contain operands used 
in calculations, and the B registers are used for 
incrementing and indexing. 

All addresses in a relocatable program are relative to 
a base address of zero. When a relocatable program 
is loaded for execution, the zero base address is 
assigned to a reference address. At that time, all 
addresses in the program become relative to the 
reference address. 



Relocatable Assembly 



Removable Device 



In the context of this manual, a COMPASS program 
assembled without the ABS pseudo instruction. The 
CYBER Loader will be required to convert relative 
addresses into absolute addresses and to satisfy 
external references. 

A rotating mass storage device which can be physically 
detached from the RMS drive. 
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Rollout 



Rollout File 

Rotating Mass Storage (RMS) 

Sector 

Security Count 



The removal of jobs from central memory to mass 
storage before execution is complete, so the control 
point and central memory can be assigned to another 
job. A job is rolled out when it is waiting for an 
external resource or event, when its control point 
and /or central memory is needed by a higher priority 
job, or when it exceeds its central memory time slice. 

A file containing a job (and system information) that 
has been temporarily removed from the main pro- 
cessing area of the system. 

An 844 or 885 disk storage device. 

Equivalent to PRU for mass storage devices. 

The number of security violations the user has left 
before he is denied access to the system. 



Security Violation 



Sense Switches 



Sequential Access 



Sequential File 



Short PRU 



Special Entry Point 



The result of a user action that resulted in a system 
abort of the job step and termination without recovery 
of the job. 

Six 1-bit flags located in the user's control point area 
and in bits 11 through 6 of RA+0 of the job field length. 
These bits can be used to communicate with systena 
routines (refer to the ONSW and OFFSW macros in 
section 6). 

A method in which only the record located at the 
current file position can be accessed. Refer to 
random access. 

A file in which records are accessed in the order in 
which they occur. Any file can be accessed 
sequentially. 

A PRU that does not contain the maximum number of 
words of data allowed for a PRU on that device. 
Refer to zero length PRU. 

An entry point that enables system programs to per- 
form special functions (refer to appendix F). 



SRU 



Standard Labeled Tape 



Symbol 



System Library (SYSLIB) 



System resource unit. A unit of measurement of 
system usage. The number of SRUs includes the CPU 
time, memory usage, and l/O activity. 

A tape with labels conforming to American National 
Standard Magnetic Tape Labels for Information 
Interchange. 

A set of characters that identifies a value and its 
associated attributes. 

The collection of tables and object language programs 
residing in central memory or on mass storage which 
are necessary for running the system and its product 
set. 
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System i^'ile 
S.ystem ilequest 

System Text 

Tape Format 
Tape Mark 

Temporary File 

Time Slice 

Timed /Event Rollout File 

Unlabeled Tape 

User Index 

User Number 
Validation File 

Volume 

VSN 



A file that can be accessed only by a system progr-am. 

A request placed in location HA+ 1 for a function 
processor to perform a special process. 

A set of tables containing symbol, micro, macro, and 
opdef definitions that can be saved on a file to be 
accessed by other programs. 

A parameter that specifies the internal recording 
format of a magnetic tape. Refer to appendix .] . 

A short record written on tapes under operating system 
control to separate label groups, files, and /or labels. 
Interpretation depends on the tape format. 

A file that is currently associated with a job and is 
temporary in nature. That is, all temporary files 
cease to exist once they are returned to the system 
(either specifically or at job termination). 

The amount of CPU or CM time a job is allowed to 
use before the system lowers its priority to allow 
other jobs to execute. 

A rollout file whose job is returned to execution when 
a requested event has occurred or a specified time 
period has elapsed. 

A magnetic tape that does not have a header label. 
Unlabeled tapes generated by the operating system 
contain a trailer label similar to the trailer for a 
standard labeled tape. 

A unique 17-bit identifier that is associated with each 
user number. The user index is used by the perma- 
nent file manager to identify the device and catalog 
track for the user's files. 

A one- to seven-character name that identifies the 
user to the system and for which there is assigned a 
user index that allows access to permanent files. 

File containing validation information for all users 
(user names, passwords, resources allowed, and 
so on). 

A term synonymous with a reel of tape. 

Volume serial number. A one- to six-character 
identifier that identifies the volume of magnetic tape 
to the system. 
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Word 



Write Ring 



Zero Byte Terminator 



A group of bits (or 6 -bit characters) between bound- 
aries imposed by the computer system. A word is 
60 bits in length. The bits are numbered 59 through 
starting from the left. It is also composed of five 
12 -bit bytes, numbered through 4 from the left. 

A circular device (inserted into a tape reel indicating 
to the tape unit that it can write on that reel. NOS 
enforces the presence or absence of a write ring if 
the user requests it (refer to section 4). 

The 12 bits of zero in the low order position of a 
central memory word that are used to terminate a 
line of coded information. 



Zero Length PRU 



CIO coded l/O operations, control statement, and 
dayfile processing macros use files whose lines are 
terminated by a zero byte. 

In display code, two colons create 12 bits of zeros. 
If two consecutive colons occur in a file that contains 
zero-byte terminated records, they might be stored 
in the lower order portion of a word and create a 
zero-byte terminator. 

A PRU that contains no user data. The level desig- 
nator specifies whether the PRU is an EOR or EOF 
(refer to level designator). 



2-C-14 



60445300 M 



SPECIAL USER INFORMATION 



Appendix E provides special information available to the applications programmer. The 
following topics are described. 

• Job communication area 

• Exchange package area 

• File types and job origin codes 

• Equipment codes 



JOB COMMUNICATION AREA 



Figure 2-E-l illustrates the first 101 words of the user's field length. 

o 
59 40 35 29 23 17 14 II 5 



RA+0 
+ 1 
-f-2 



+ 27 

+47 

+ 64 
+ 65 
+ 66 
+67 
+70 



+77 




m 



% 



argument 



parameters from the program call statement 
(available to the user during job execution) 



clwe 



clfw 



special program parameter area 



jot 



2^ 



control statement image 
(may be replaced by operator message) 



np 



f wo 



ARGR 



SPPR 



PGNR, ACTR 
CMUR, LWPR 
XJPR, JOPR, FWPR 
CSMR, LDRR 
CCDR 



Figure 2-E-l. Job Communication Area 
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Word 



RA+0 



System 
Identifier 



Bits 



Field 



RA + l 



RA+2 

through 

RA+eSg 

RA+2 7 3 
through 
RA+473 



RA+64, 



RA+653 



ARGR 



SPPR 



RA+66, 



XJPR 



JOPR 



FWPR 



59-15 


reserved 


14 


cf 


13 


1 


12 


P 


11-06 


ssw 


05-00 


reserved 


59-41 


sname 


40 


r 


39-36 


unused 


35-00 


arguments 



59-00 



59-00 



17-00 



59 



params 



params 



PGNR 


59-18 


nam 


ACTR 


17-00 


np 


CMUR 


59 


cm 


LWPR 


58-36 


clwe 




35-19 


unused 




18 


lb 



nwa 



m 



58-36 


clfw 


35-24 


jot 


23-20 


unused 


19 


d 


18 


r 


17-00 


fwo 



Significance 

Reserved . 
CFO bit. 

Subsystem idledown flag . 
, Pause flag . 
Sense switches . 
Reserved . 

System request name (such as CIO) . 
Auto recall flag , 
Reserved for future system use , 
Parameters passed to that portion of 
the system that processes the sname 
request , 

Parameters from the program call 
statement; available to the user during 
execution . 

Special program parameter area used 
by SSJ= entry point programs to store 
parameter blocks. Any job step can 
use this area for its own purpose, but 
if it Is followed by an SSJ= program, 
the contents may be destroyed. 

Name of program called by control 
statement . 

Number of parameters in control state- 
ment call . 

Set if the compare /move unit (CMU) is 

present 

LWA+1 of loadable area in ECS. 

Reserved for future system use. 

Library flag: 

Load from a file 

1 Load from library 
Address of next word available for 
loading. If Common Memory Manager 
is loaded in the user's field length, bits 
17 through contain the complement of 
the address of the next word available 
for loading (refer to the Common 
Memory Manager Reference Manual). 

Indicates if hardware feature CEJ/ 
ME J is available: 

1 Available 

Not available 
FWA of loadable area in ECS. 
Job origin type. 

Reserved for future system use. 
DIS flag. 
RSS flag. 
First word of object program. 
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RA+67, 



RA+TOg 
through 
RA + 77„ 



CSMR 


59 


cs 


LDRR 


58-30 
29 


unused 
c 




28-00 


unused 


CCDR 


59-00 


control 

statement 

image 



Set if system is running in 64-character 
set mode. 

Reserved for future system use. 
Completion flag: 

Load not completed 

1 Load completed 
Reserved for future system use. 

Image of control statement currently 
being executed . 



EXCHANGE PACKAGE AREA 

Figure 2-E-2 illustrates the exchange package area for CYBER 170 Series, CYBER 70 
Series, and 6000 Series computer systems. This illustration and the description that fol- 
lows it are intended for use by the applications programmer and, therefore, do not include 
descriptions of bits or fields not used by applications programs. 





59 




53 




47 


35 


17 


000 


'Wa 


P 


AO 


BO 


001 


W 


RA 


Al 


Bl 


002 




FL 


A2 


B2 


003 


W///. 


EM 


COND 


A3 


B3 


004 


i 


RAE 


A4 


B4 


005 


i 


FLE 


A5 


B5 


006 


W//////////////M 


A6 


B6 


007 


W//////////////M 


A7 


B7 


010 


xo 


Oil 


X 1 


012 


X2 


013 


X3 


014 


X4 


015 


X5 


016 


X6 


017 


X7 



Figure 2-E-2. Exchange Package Area 
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The exchange package area fields are defined as follows (fields are applicable to all NOS 
computer systeins unless otherwise noted). 

Field Description 

P Program address. (0 < P < FL - 1) 

Ai Address registers. 

Bi Increment registers. 

RA Reference address for central memory. 

FL Field length for central memory. Bit 53 is zero for all appli- 

cations programs. 

EM Exit modes. An exit mode is selected or disabled by setting 

or clearing the appropriate bit (refer to the MODE macro). 

Bit Meaning when bit is set 

50 Exit on indefinite operand. 

49 All models except model 176: Exit on operand 

out of range (infinite operand). 

Model 176: exit on overflow. 

48 All models except model 176: Exit on address 

out of range. 

Model 176: Exit on underflow, t 
COND Error condition flags (CYBER 170 model 176 only). , 

Bit Description 

47, 46 Reserved for Control Data. 

45 ECS block range condition. 

44 CM block range condition. 

43 ECS direct range condition. 

42 CM direct range condition. 

41 Program range condition. 

40 Not used. 

39 Step condition. 

3 8 Indefinite condition. 

37 Overflow condition. 

36 Underflow condition. 

RAE Reference address for ECS. 

FLE Field length for ECS. Bit 56 is zero for all applications 

programs. 

Xi Operand registers. 



tAn address out of range condition always causes a program exit on a CYBER 170 Model 
176. 
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FILE TYPES AND ORIGIN CODES 



The following file types and origin codes are used in many NOS system routines. 
The queue file types are: 

Description 



Type 



Value 



INFT 





Input 


ROFT 


1 


Rollout 


PR FT 


2 


Print 


PHFT 


3 


Punch 


TEFT 


4 


Timed /event rollout 


-- ■ 


5 


Reserved 


-- 


6 


Reserved 


-- 


7 


Reserved 



Other file types include: 



Type 


Value 


Description 


LIFT 


10 


Library 


PTFT 


11 


Primary terminal 


PMFT 


12 


Direct access permanent file 


FAFT 


13 


Fast attach file 


SYFT 


14 


System 


LOFT 


15 


Local 


-- 


16 


Reserved 


g are the job 


origin codes. 




Type 


Value 


Description 


SYOT 





System 


BOOT 


1 


Local batch 


EIOT 


2 


Remote batch 


TXOT 


3 


Time -sharing 


MTOT 


4 


Multiterminal 
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EQUIPMENT CODES 

Equipment codes for device types supported by NOS are as follows: 





Display 


Mnemonic 


Code (Octal) 


CP 


0320 


CR 


0322 


DE 


0405 


Din 


0411 


DJn 


0412 


DKn 


0413 


DLn 


0414 


DMn 


0415 


DP 


0420 


DQn 


0421 


DS 


0423 


LP 


1420 


LR 


1422 


LS 


1423 


LT 


1424 


MS 


1523 


MT 


1524 


NE 


1605 


NP 


1620 


NT 


1624 


ST 


2324 


TT 


2424 



Equipment 

415 Card Punch 

40 5 Card Reader 

Extended Core Storage 

844-21 Disk Storage Subsystem (1 to 8 units, half track) 

844-4x Disk Storage Subsystem (1 to 8 units, half track) 

844-21 Disk Storage Subsystem (1 to 8 units, full track) 

844-4x Disk Storage Subsystem (1 to 8 units, full track) 

885 Disk Storage Subsystem (1 to 3 units, half track) 

Distributive data path to ECS 

885 Disk Storage Subsystem (1 to 3 units, full track) 

Display console 

Any line printer 

580-12 Line Printer 

580-16 Line Printer 

580-20 Line Printer 

Mass storage device 

Seven-track magnetic tape drive 

Null equipment 

2 55x Host Communications Processor 

Nine-track magnetic tape drive 

6671 or 2550-100 multiplexer 

6676, 6671, or 2550-100 multiplexer 
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COMPRESSED COMPILE FILE 



A compressed compile file (figure 2-G-9) has a one-word header 





59 




47 




35 


17 


II 





Word 


7700 


0016 


char set 





1 


modnomei 


seq. no. | 


2 


compressed line | 










• 
• 
• 






V 




modnamep 


seq. no.p 




compressed linep 



char set Character set of the compressed compile file. 

63 -character set. 
64 64-character set. 



modname. 



One- to seven-character modification set name. 



seq. nOj^ Sequence number of the line image according to 

the position in the deck or modification set. 



Figure 2-G-9. Compressed Compile File Format 
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INDEX 



Abnormal termination codes (refer also to 
error codes) 2-2-5; 2-3-2 
Abort 

CPU 2-6-6; 2-11-1 

Defined 2-C-l 

PP 2-6-6 

Program 2-10-6; 2-12-4 
ABORT macro 2-11-1 
ABS record type 2-G-5 
Absolute record type 2-G-5 
Absolute assembly 2-C-l 
ABT request 2-11-1 
Access mode 2-5-2,8 
Access subsystem 2-12-18 
Accessing files 2-3-4 
Account block 2-C-l 
Account block SRU limit 2-6-2,10 
Accounting information 2-6-18 
ACTR symbol 2-1-8; 2-E-2 
Address 

Error, CIO 2-3-3 

Out of range 2-E-4 

Registers 2-E-4 
Allocatable device 2-C-l 
Alphanumeric 2-C-l 
ALTER function 2-3-11 
Alternate storage fields 2-5-18 
Alternate user number 2-2-13; 2-5-2; 
2-C-l 

ALTERNR function 2-3-11 
ANSI 2-C-l 

ANSI labels 2-3-14,41; 2-4-15 
APPEND macro 2-5-25 
Appending information to a file 2-5-25 
Applications programs, converting 
2-12-1 
ARET error 2-6-6 
ARG= entry point 2-F-l 
ARGR symbol 2-1-8; 2-E-2 
Argument address 2-1-8; 2-E-2 
Arithmetic error 2-6-6 
ASCn 2-C-l 

ASCn/display code conversion 2-4-16 
ASCn mode 2-12-6,8,19 
ASCn input byte 2-12-6 
ASCn output byte 2-12-8 
Assign file to queue device 2-7-5 
ASSIGN macro 2-4-3,13 
Assigning 

Equipment 2-4-9,11 



Files 2-4-3,12,15; 2-7-5; 2-12-2 

Nonallocatable devices 2-4-10 

Packs 2-4-9 

Resources 2-4-9,11,15 

Tape units 2-4-15 
ATTACH macro 2-5-31 
Auto input byte 2-12-5 
Auto recall 

CIO 2-3-1 

Defined 2-C-l 

DSP 2-8-1 

LFM 2-4-1 

PFM 2-5-1 

Processing 2-1-3 

TIM 2-9-1 

* option 2-3-30,32,34,36 
Automatic file flushing 2-2-8; 2-6-30; 
2-12-2 

Automatic tape assignments 2-4-20 
Auxiliary device requests 2-5-11 
Auxiliary devices 2-2-14; 2-5-11; 
2-C-l 



Backspacing a file 2-3-36,37,48 

Backup requirement 2-5-2,10 

BASIC subsystem 2-5-10; 2-12-18 

Batch origin type 2-E-6 

Batch subsystem 2-5-10; 2-12-18 

BOOT 2-E-6 

Binary 

File mode bit 2-2-6 

Formats 2-G-l 

Input mode 2-12-6 

Output mode 2-12-7 

Random file, FET creation 2-2-12 

Sequential file, FET creation 
2-2-12 
BKSP macro 2-3-36 
BKSPRU macro 2-3-37 
Block 2-C-l 

Block size 2-3-25,29,36; 2-4-19,28; 
2-J-l 

Blocked data format 2-4-19 
BOI 2-C-l 

BUF parameter 2-2-13,15 
Buffer 

Circular 2-2-1 

Defined 2-C-l 
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Empty, defined 2-2-3 
Full, defined 2-2-3 
Pointers 2-2-2 
Sizes 2-2-13,15 
Working 2-3-50 
Byte 2-C-2 



*CALL directive 2-1-10 
CAP record type 2-1-20; 2-G-5 
fl Capsules, fast dynamic load 2-11-16,18; 
2-C-2 

Carriage control, terminal 2-12-4,7 
Catalog errors 2-5-18 
Catalog information 2-5-16 
Category, file 2-5-8 
CATLIST macro 2-5-16; 2-A-l 
CCAP symbol 2-5-25 
CCAT symbol 2-5-31 
CCCG symbol 2-5-32 
CCCT symbol 2-5-16 
CCDF symbol 2-5-26 
CCDR symbol 2-1-8; 2-E-2 
CCGT symbol 2-5-14 
I CCL procedure records 2-11-16; 2-G-5 
CCPG symbol 2-5-15 
CCPM symbol 2-5-22 
CCRP symbol 2-5-24 
CCSV symbol 2-5-12 
CEJ/MEJ option 2-1-4,8; 2-11-5; 2-E-2 
Central exchange jump/monitor exchange 
jump option (refer to CEJ/MEJ option) 
Central memory 

Data error 2-E-4 

Defined 2-C-2 
I Dumps 2-1-16; 2-11-12 

Field length 2-6-16 

Parity error 2-6-6 
I Size 2-11-6 

Central processor unit (refer to CPU) 
CHANGE macro 2-5-32 
Character sets 2-1-8; 2-11-5; 2-12-19; 
2-E-2 
Checkpoint 

Defined 2-C-2 

Dumps 2-4-10; 2-10-3 

Files 2-10-3 
Checkpoint/restart 2-10-3 
CHECKPT macro 2-10-3; 2-A-l 
Checksum 2-10-9; 2-C-2 
CIO 

Abnormal termination codes 2-3-2 

Common decks 2-3-4 

Detail error return codes 2-3-3 

FET format 2-3-2 

Function processing 2-3-4 

Random processing 2-3-9 



Read functions 2-3-22 

Request 2-3-1 

Write functions 2-3-30 
Circular 

Buffers 2-2-1; 2-C-2 

Read operation 2-2-3 

Write operation 2-2-4 
Circular buffer flushing 2-2-8; 2-6-30; 
2-12-2 

CKP 2-10-3 
Clock cycle count 2-9-3 
CLOCK macro 2-9-1 
CLOSE macro 2-3-18 
CLOSER macro 2-3-21 
Closing a file 2-3-18,21 
CM (refer to central memory) 
CMC input error 2-E-4 
CMU option 2-1-8; 2-11-5; 2-C-2; 2-E-2 
CMUR symbol 2-1-8; 2-E-2 
Coded 

FUe mode 2-2-6 

Random file, FET creation 2-2-12 

Sequential file, FET creation 
2-2-12 
Coding specification 2-1-8 
Combined input/output (refer to CIO) 
COMCARG 2-A-4 
COMCARM 2-A-4 
COMCCDD 2-A-4 
COMCCFD 2-A-4 
COMCCHD 2-A-4 
COMCCIO 2-A-4 
COMCCMD 2-1-9; 2-A-3 
COMCCOD 2-A-4 
COMCCPA 2-A-4 
COMCCPM 2-A-4 
COMCCPT 2-A-4 
COMCCVI 2-A-4 
COMCCVL 2-A-4 
COMCDXB 2-A-4 
COMCECM 2-A-4; 2-D-l 
COMCECS 2-A-4; 2-D-l 
COMCEDT 2-A-4 
COMCFCE 2-A-4 
COMCFQO 2-A-4 
COMCHXB 2-A-4 
COMCIQP 2-A-4 
COMCLFM 2-A-4 
COMCLOD 2-A-4 
COMCMAC 2-1-9; 2-A-l 
COMCMTM 2-A-4 
COMCMTP 2-A-5 
COMCMVE 2-A-5 
COMCOVL 2-A-5 
COMCPFM 2-A-5 
COMCPFU 2-A-5 
COMCPOP 2-A-5 
COMCQFM 2-A-5 
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COMCRDC 2-A-5 
COMCRDH 2-A-5 
COMCRDO 2-A-5 
COMCRDS 2-A-5 
COMCRDW 2-A-5 
COMCRSP 2-A-5 
COMCRTN 2-A-5 
COMCSFM 2-A-5 
COMCSFN 2-A-5 
COMCSNM 2-A-5 
COMCSRT 2-A-5 
COMCSSN 2-A-5 
COMCSST 2-A-5 
COMCSTF 2-A-5 
COMCSYS 2-A-5 
COMCUPC 2-A-5 
COMCUSB 2-A-5 
COMCVFE 2-A-5 
COMCWOD 2-A-5 
COMCWTC 2-A-5 
COMCWTH 2-A-5 
COMCWTO 2-A-5 
COMCWTS 2-A-5 
COMCWTW 2-A-5 
COMCZAP 2-A-5 
COMCZTB 2-A-5 
Comment field 2-1-7 
COMMENT statement 2-1-12 
Common decks 

Available to user 2-A-l 

CIO 2-3-4 

CPM 2-6-1 

Data transfer macros 2-3-52 

Defined 2-C-2 

LFM 2-4-1 

PFM 2-5-1,3,7 

QFM 2-7-1 
I Relocatable 2-A-6 

SYSLIB 2-A-6 

System requests 2-11-1 

TCS 2-10-1 

Usage 2-1-9 
COMMON macro 2-4-4; 2-A-3 
Compare/move unit option (refer to CMU 
option) 

COMPASS 2-C-2 
COMSPFM 2-5-1,3,8 
Conflict of tags 2-1-12 
I Console, display a message 2-11-8 
Control bytes 2-12-5; 2-C-2 
CONTROL macro 2-10-1 
Control point 

Area 2-6-1 
I Dayfile 2-11-1 

Defined 2-C-2 

Manager 2-6-1 
Control statement 

Buffer 2-10-2 



Count 2-4-13 

Execute 2-10-2 

File 2-4-13,14; 2-10-1 

Image 2-1-8; 2-10-1; 2-E-2 

Input buffer 2-10-2 

Parameters 2-10-1; 2-E-2 

Processing 2-10-1 

Record 2-C-3 
Control words 2-3-24,32; 2-5-2 
Conversion mode 2-4-16,28 
Converting applications programs 2-12-1 
CPET error 2-6-6 
CPM, common decks 2-6-1 
CPM request 2-6-1 
CPU 

Abort 2-6-2,6; 2-11-1 

Common decks 2-1-9; 2-A-l 

Defined 2-C-3 

Error exit 2-6-2,6; 2-E-4 

Hardware error exit mode 2-6-2 

Parity error 2-6-6 

Priority 2-6-2,13 

Program error exit mode 2-6-2,6; 
2-E-4 

Select 2-6-19 

Time 2-9-3,6 

Time limit 2-6-4 
Creating 

Direct access file 2-5-26 

Indirect access file 2-5-12,24 

Labeled tape 2-4-15 

Library file 2-4-4 

Random file 2-H-l 
Creation date 2-2-11; 2-4-20; 2-J-8 
CSET macro 2-12-16; 2-A-l 
CSMR symbol 2-1-8; 2-E-2 
Current 

Date 2-9-2,4 

Random index 2-2-10; 2-3-3 

Time 2-9-1,4 
CVL request 2-11-5 
CYBER Control Language records 
2-11-20; 2-G-5 

CYBER Interactive Debug 2-10-6 
CYBER Loader 2-C-3 
CYBER Record Manager 2-C-3 



Data 

Error in file 2-5-18 

Format 2-4-19; 2-J-l 

Transfer macros 2-3-49 
Date, current 2-9-2,4 
DATE macro 2-9-2 
Date, packed 2-9-4 

Dayfile, displaying information 2-11-1,8; 
2-C-3 
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DAYFILE macro 2-11-1; 2-A-l 
Dayfile messages 2-4-18; 2-11-1,8 
Default 2-C-3 
Deferred batch jobs 2-7-3 
Deferred file routing 2-8-3 
DEFINE macro 2-5-26 
Density, tape 2-4-16,28 
Detail error return code 2-3-3 
Device 

Auxiliary 2-5-11 

Not ready error 2-3-3 

Reserved error 2-3-3 

Status errors 2-3-3 

Type 2-2-6,13,15; 2-3-12; 2-4-7,25; 
2-C-3; 2-E-6 
Diagnostic messages 2-B-l 
Direct access files 

Attaching 2-5-31 

Creating 2-5-26 

Defined 2-C-3 

PRUs desired 2-5-2 

Purging 2-5-15 

Type 2-E-6 
Disable 

CM dumps 2-1-16 

Hardware exit mode 2-6-2; 2-E-4 

Program exit mode 2-6-2; 2-E-4 
Disconnect terminal 2-12-6 
Display code 2-C-3 
Display code conversion 2-4-16 
Display code dumps 2-11-12 
Dispose processor 2-8-1 
Disposition code 2-8-2; 2-C-3 
DISTC macro 2-12-13; 2-A-l 
Distributive data path 2-E-6 
Division, integer 2-1-7 
DMD request 2-11-12 
DMP request 2-11-12 
DMP= entry point 2-F-l 
DOCMENT statement 2-1-1 
Documentation cards 2-1-2 
Documentation standards 2-1-1 
DSP request 2-8-1 
DTY parameter 2-2-13,15 
Dump, memory 2-1-16; 2-11-12 



*E directive 2-1-7 
ECET error 2-6-6 
ECS 

Defined 2-C-3 
I Dumps 2-11-12 

Field length 2-6-16,20,28,32; 
I 2-11-6; 2-E-5 

Interpretive mode reading and writing 
2-D-l 
Parity error 2-6-6; 2-E-4 



Size 2-11-5 

Systems text 2-1-6 

Transfers 2-D-l 
ECSTEXT 2-1-6; 2-D-l 
EDATE macro 2-9-2; 2-A-l 
EIOT 2-E-6 

EM register 2-6-2; 2-E-4 
Empty buffer, defined 2-2-3 
Empty record 2-C-4 
ENCSF macro 2-4-14; 2-A-l 
END request 2-11-4 
End-of-block byte 2-12-5 
End-of-device status 2-3-2 
End-of-file (refer to EOF) 
End-of-information (refer to EOI) 
End-of-line 2-12-5; 2-C-4 
End-of-record (refer to EOR) 
End-of-reel 2-3-2,21; 2-4-19; 2-J-6 
End-of-string byte 2-12-8 
End-of-tape (refer to EOT) 
End-of-tape processing 2-4-19; 2-J-6 
End-of-transaction block 2-12-8 
End-of-transaction block with response 
2-12-8 

ENDRUN macro 2-11-4 
Entry point 2-C-4 
EOF 2-2-5,6; 2-3-50; 2-C-4 
EOFl label 2-3-20 
EOF 2-9 labels 2-3-20 
EOI 2-2-6; 2-3-50; 2-C-4 
EOR 2-2-5,6; 2-3-50; 2-C-4 
EOVl label 2-3-20,21 
E0V2 label 2-3-21 
EPR parameter 2-2-13 
Equipment 

Codes 2-C-4; 2-E-6 

File assignment 2-4-9,11 

Number 2-4-25 
ERA parameter 2-2-15 
EREXIT macro 2-6-5 
ERP parameter 2-2-15 
Error 

Class 2-10-9 

Code 2-10-9 

Control 2-6-2,5 

Correction 2-4-17 

Data in file 2-5-15 

Exit address 2-6-5; 2-E-5 

Exit mode 2-6-2,5,14; 2-E-4 

File length 2-5-18 

Flag 2-6-6,31; 2-10-9; 2-11-1 

Messages 2-B-l 

Permit entries 2-5-18 

Processing 2-2-7; 2-3-4; 2-4-16,29; 
2-8-5 

Processing bit 2-2-7,13,15; 2-5-1 

Recovery 2-4-17 

Return address 2-2-15 
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Error cx)des 

Catalog 2-5-15 

CIO 2-3-2,3 

DSP 2-8-1 

LFM 2-4-2 

PFM 2-5-3 
I RPV 2-10-10 

EST ordinal 2-C-4 
I ETIME macro 2-9-3; 2-A-l 
Event descriptor 2-6-9 
EVICT macro 2-3-46 
Evicting a file 2-3-46 
Exchange jump 2-1-5; 2-C-4 
Exchange package 2-10-9; 2-12-14; 
2-C-5; 2-E-3 

EXCST macro 2-10-3; 2-A-l 
Execute subsystem 2-5-10; 2-12-18 
Exit mode 2-6-2,5,14,31; 2-C-5; 2-E-4 
Expiration date 2-4-20; 2-J-8 
Extended label processing 2-2-7; 2-3-16, 
42.1; 2-C-5 
External 

Characteristics, routed file 2-8-2 

Documentation 2-1-2 

Reference 2-C-5 



F format tape 2-4-19; 2-J-l,5 
FAFT file type 2-E-6 
Family device 2-C-5 
Family name 2-6-28 
Fast attach file 2-E-6 
I Fast dynamic load 2-11-16,18; 2-C-5 
^FCPB category 2-5-9 
FCPR category 2-5-9 
FCSP category 2-5-9 

fFDL 2-11-16,18 
FDL capsules 2-11-16,18 
FET 

Creation macros 2-2-11 

Description 2-2-4; 2-C-5 

LABEL macro 2-4-15 

Length 2-2-9,13 

Modification macro 2-2-14 

Parameters 2-2-13 
FET formats 

CIO requests 2-3-2 

LFM requests 2-4-1 

PFM requests 2-5-1 

QFM requests 2-7-1 
■ SFM requests 2-11-2 

Standard 2-2-4 
Field length 
I Central memory 2-11-5; 2-E-4 

Control word 2-6-20 

Defined 2-C-5 

ECS 2-11-5; 2-E-5 



Preservation, ECS 2-6-32 

Reducing 2-6-16,27; 2-11-6 
File 

Accessibility 2-4-19; 2-J-8 

Assigning 2-4-9,11; 2-7-5 

Assignments, terminals 2-12-2 

Backspacing 2-3-36,37,48 

Backup requirement 2-5-2 

Binary 2-2-6,12 

Category 2-5-1,9; 2-C-5 

Coded 2-2-6,12 

Creation 2-2-1 

Data error 2-5-18 

Deferred routed 2-8-1 

Defined 2-C-5 

Direct access 2-5-26,31 

Flushing 2-2-8; 2-6-30; 2-12-2; 
2-C-6 

Identifier 2-2-11; 2-4-20; 2-J-8 

Information 2-4-25 

Length 2-4-25 

Length error 2-5-15 

Limit error 2-6-6 

Local 2-4-1 

Magnetic (refer to magnetic tape file) 

Mode 2-2-6; 2-5-2,8 

Name 2-2-5 

Name table (refer to FNT) 

Password 2-5-2 

Permission mode 2-4-26; 2-5-2,8 

Positioning 2-3-36 

Preferred residence 2-5-2 

Privacy 2-6-32 

Private 2-5-9 

Public 2-5-9 

Purging 2-5-15 

Random 2-2-9,11; 2-3-4,9; 2-C-ll 

Replacing 2-5-24 

Residency 2-5-11,26 

Returning 2-3-40 

Rewinding 2-3-37 

Routing 2-8-1 

Saving 2-5-12,24 

Section number 2-2-11; 2-4-19; 

2-J-8 

Semiprivate 2-5-9 

Sequence number 2-2-11; 2-4-20 

Sequential 2-2-12; 2-3-4; 2-C-12 

Set 2-C-6; 2-J-8 

Skipping 2-3-46,47 

Space, releasing 2-3-40,46 

Status 2-4-25 

Types 2-4-22,26; 2-C-6; 2-E-5 
File environment table (refer to FET) 
FILEB macro 2-2-12 
FILEC macro 2-2-12 
FILINFO macro 2-4-25 
FIRST pointer 2-2-2,9 
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FL 2-E-4 

Flag 2-C-6 

FLE 2-E-5 

FLET error 2-6-6 

Flush bit 2-2-8; 2-6-31; 2-12-3 

FNT entry 2-4-8,21; 2-C-6 

FNT pointer 2-2-9 

Forced error 2-6-6 

Formats, magnetic tape 2-J-l 

Forms code 2-8-2 

FORTRAN subsystem 2-5-10; 2-12-18 

FSET error 2-6-6 

FST entry 2-4-8,21; 2-C-6 

FTNTS subsystem 2-5-10; 2-12-18 

Full buffer, defined 2-2-3 

Full track 2-C-6 

Function processors 2-1-1; 2-C-6 

FWPR symbol 2-1-8; 2-E-2 



GE write mode 2-4-17 
Generation number 2-4-20; 2-C-7; 2-J-8 
Generation version number 2-2-11; 
2-4-20; 2-J-8 
GET macro 2-5-14 
GETACT macro 2-6-26; 2-A-3 
GETASL macro 2-6-13; 2-A-l 
GETEM macro 2-6-13; 2-A-3 
GETFLC macro 2-6-20; 2-A-l 
GETFNT macro 2-4-22; 2-A-l 
GETGLS macro 2-6-24; 2-A-l 
GETJA macro 2-6-18; 2-A-l 
GETJCI macro 2-6-31; 2-A-3 
GETJCR macro 2-6-16; 2-A-l 
GETJN macro 2-6-11; 2-A-2 
GETJO macro 2-6-18; 2-A-2 
GETJSL macro 2-6-14; 2-A-2 
GETLC macro 2-6-23; 2-A-2 
GETLOF macro 2-6-29; 2-A-3 

I GETMC macro 2-11-5; 2-A-2 
GETPFP macro 2-6-28; 2-A-2 
GETPR macro 2-6-12; 2-A-2 
GETQP macro 2-6-12; 2-A-2 
GETSS macro 2-6-22; 2-A-2 
GETTL macro 2-6-14; 2-A-2 
Global error flag 2-6-31 
Global library set indicators 

I 2-6-24,25; 2-11-17; 2-C-7 
Global register 2-6-31 

I Group, capsules 2-11-16 



Half track 2-C-7 

Hardware error exit mode 2-6-2; 2-E-4 
HDRl label 2-3-14,41; 2-4-20; 2-J-7 
Header documentation 2-1-7 



HTIME macro 2-9-3 



I format tape 2-4-19; 2-J-l, 2 
lAF 2-12-4 
ID code 2-4-12 
ID, machine 2-6-26 
Identification code 2-4-12; 2-7-4 
lUegal user statement 2-7-3 
IN pointer 2-2-3,9 
Increment registers 2-E-4 
IND parameter 2-2-13 
Indefinite operand 2-E-4 
Index length 2-2-10,13 
Index, random 2-2-9 
Indirect access files 

Accessing 2-5-14,36 

Appending information 2-5-25 

Changing parameters 2-5-32 

Creating 2-5-12,24 

Defined 2-C-7 

Purging 2-5-15 

Replacing 2-5-24 

Saving 2-5-12,24 

Working copy 2-5-14,36 
INFT type files 2-E-5 
Inhibit error processing 2-4-16 
Initiate ASCII output 2-12-8 
Input, binary 2-12-6 
Input file 

Releasing 2-3-40 

Returning 2-3-40 

Type 2-C-7; 2-E-5 
INPUT file, terminal 2-12-2 
INPUT* file 2-3-40 
Input, transparent 2-12-6 
Input/output buffers 2-2-1; 2-3-49 
Input/output, COMPASS 2-3-1 
Input/output queue protection 2-7-1 
Input/output, record manager 2-3-57 
Integer divide instruction 2-1-7 
Interactive facility 2-12-4 
Interactive I/O 2-12-1 
Interactive programs 2-C-7 
Internal characteristics, routed file 
2-8-3 
Internal documentation 2-1-1 
Interpretive mode ECS reads and writes 
2-D-l 

Interrecord gap 2-C-7 
Interruption sequence 2-12-11 
Interrupts 2-10-6; 2-C-7 
I/O activity 2-6-27 
I/O sequence error 2-4-2 
Irrecoverable parity error 2-4-16 
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I JDATE macro 2-9-4 
Job 

Abort 2-11-1 

Accounting information 2-6-18 

Communication area 2-E-l 

Control 2-10-1 

Control information 2-6-31,32 

Control registers 2-6-16,17 
I Field length 2-6-16,20,27; 2-11-6 

Name 2-6-12 

Origin 2-6-18 

Origin type 2-1-8; 2-E-2,6 

Priority 2-6-1,2,13 

Rerun error 2-6-6 

SRU limit 2-6-2,3,10 

Step 2-C-7 

Step limit 2-6-3,10 

Submitting 2-7-3; 2-8-1 
JOPR symbol 2-1-8; 2-E-2 
I Julian date 2-9-4 



K display messages 2-6-8 
Keyboard buffer address 2-6-8 



L display messages 2-6-8 
L format tapes 

Defined 2-J-5 

Reading 2-3-28 

Specification 2-4-19 

Writing 2-3-45 
Label 

Bit 2-4-15 

Buffer 2-3-16,42 

Defined 2-C-7 

Type 2-4-28 

Verification 2-3-11,43 
LABEL macro 2-4-15 
Label processing 

ANSI tapes 2-4-15 

Extended 2-2-7; 2-3-16,42 

Standard 2-2-7; 2-3-14,41 
Labeled tape 2-4-15 
LBL parameter 2-2-13 

ILDD request 2-11-16 
LDQ request 2-11-18 
LDR completion 2-1-8; 2-E-2 
i LDR request 2-11-13 
. LDRR symbol 2-1-8; 2-E-2 
I Length of FET 2-2-9,13 
Length of index 2-2-10,13 
Level designator (refer to Level number) 
Level number 2-2-5; 2-3-2,24,25; 
2-C-7 



LFM 

Call format 2-4-1 

Common decks 2-4-1 

Error codes 2-4-2 

FET format 2-4-1 

Request 2-4-1 
Ifn (refer to local file name) 
LFN parameter 2-2-16 
Library 2-C-8 
Library file 

Accessing 2-4-3,12 

Defined 2-C-8 

Creation 2-4-4 

Returning 2-3-40 

Type 2-E-6 
Library system default 2-1-9 
LIFT type files 2-E-6 
LIMIT pointer 2-2-3,9 
Line 2-C-8 

Line feed, suppress 2-12-5,8 
Lines/printer page 2-1-8; 2-E-2 
LIN? symbol 2-1-8; 2-E-2 
List address 2-2-10; 2-3-26 
List of files 2-2-8; 2-6-29; 2-C-8 
Load point 2-C-8 
LOADD macro 2-11-16 
Loader control word 2-6-15,23 
Loader requests 2-11-13 
Loading overlays 2-11-13 
LOADQ macro 2-11-18 
Local file 

Defined 2-C-8 

Manager (refer to LFM) 

Name 2-2-5,13,15; 2-C-8 

Releasing 2-3-40,46; 2-4-5 

Returning 2-3-40 

Type 2-E-6 
LOCK macro 2-4-6 
Locked files 2-4-6; 2-C-8 
LOFT type files 2-E-6 
Logical record 2-3-25; 2-C-8 
Log-off user 2-12-6 
Long-term activity 2-6-26 
LWPR symbol 2-1-8; 2-E-2 



MACHID macro 2-6-26; 2-A-3 
Machine characteristics 2-11-5 
Machine ID 2-6-26 
Macro 2-C-8 
Macro usage 2-1-6 
Magnetic tape files 

Accessing 2-3-11; 2-4-15 

ANSI standard labeled 2-3-14; 2-4-15 

Assignment 2-4-15 

Block size 2-4-19,28; 2- J-1 
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Buffer size 2-2-13 

Closing 2-3-18,21 

Creating 2-3-11; 2-4-15 

Evicting 2-3-46 

Formats 2-J-l 

Information 2-4-27 

Labeling 2-3-13,14; 2-4-15 

Multifile set 2-3-41 

Nonstandard labeled 2-3-13 

Opening 2-3-11 

Requesting 2-4-15 

Returning 2-3-40 

Rewinding 2-3-37 

Standard FET 2-2-5 

Unlabeled 2-3-13 

Unloading 2-3-38 
Map flags, loader 2-6-15 
Mass storage files 

Assignment 2-4-9,11 

Buffer size 2-2-13 

Closing 2-3-18 

Evicting 2-3-46 

Opening 2-3-11 

Returning 2-3-40 

Rewinding 2-3-37 

Standard FET 2-2-4 

Unloading 2-3-38 
Maximum field length 2-6-16,20,27 
Maximum logical record size 
(refer to mlrs) 
MEM request 2-11-6 
MEMORY macro 2-11-6 
Memory, releasing 2-11-6 
MESSAGE macro 2-11-8 
Messages 2-B-l 
MFL= entry point 2-F-2 
Minimum buffer size 2-2-13 
mlrs 2-2-10; 2-3-3; 2-C-8; 2-J-4,5 
Mode, error exit 2-6-2,6; 2-E-4 
Mode, file 2-2-6 
Mode, file access 2-5-2,9 
MODE macro 2-6-2; 2-A-3 
Modify library file format 2-G-2 
Monitor address 2-E-5 
MOVE macro 2-11-10 
MSG request 2-11-8 
MTOT 2-E-6 
Multifile 

File 2-C-8 

Reels 2-3-41 

Sets 2-3-41; 2-C-8 

Tape, positioning 2-3-41 
Multireel files 2-3-41 
Multiterminal origin type 2-E-6 
Multiunit device 2-5-11 



NAM 2-12-4 

Name change, file 2-4-2; 2-5-32 

Network 2-C-8 

Network Access Method 2-12-4 

Network terminal 2-12-4,8,14; 2-C-8 

New file name 2-4-2; 2-5-2,27 

New password 2-5-32 

New permanent file name 2-5-2,32 

Noise size 2-4-19,29; 2-J-l 

Nonallocatable device 2-C-9 

Nonstandard label bit 2-4-15 

Nonstandard labels 2-3-13; 2-4-15; 2-C-9 

NORERUN macro 2-7-3; 2-A-2 

Normal exit address 2-E-5 

NOSTEXT file 2-1-6 

NR function 2-3-11,18,21 

Null subsystem 2-5-10; 2-12-18 



ODET error 2-6-6 
OFFSW macro 2-6-11 
OKET error 2-6-6 
OLD macro 2-5-36 
Old permanent file name 2-5-32 
Old program library (refer to OPL) 
On-the-fly error correction 2-4-17 
ONSW macro 2-6-11 
opdef 2-C-9 
OPEN macro 2-3-11 
Opening a file 2-3-11 
Operand out of range 2-E-4 
Operand registers 2-E-5 
Operating registers, restoring 2-10-6; 
2-12-14 

Operator assignment of equipment 
2-4-9,11 

Operator assignment of tapes 2-4-20 
Operator drop 2-6-6 
Operator killed job 2-6-6 
Operator/user communication 2-6-8 
OPL 

Common decks 2-1-9; 2-G-3 

Defined 2-C-9 

Format 2-G-2 

Record type 2-G-5 
OPLC record type 2-G-5 
OPLD format 2-G-5 
OPLD record type 2-G-5 
ORET error 2-6-6 
Origin type 

Local batch 2-E-6 

Multiterminal 2-E-6 

Remote batch 2-E-6 

System 2-E-6 

Time-sharing 2-E-6 
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OUT pointer 2-2-3,9 
Output 

Automatic 2-2-8; 2-6-30; 2-12-2 

Binary 2-12-7 

File, terminal 2-12-2 

Problems, terminals 2-12-2 

Transparent 2-12-7 
Outstanding system activity 2-6-26 
Overlay 2-11-13; 2-C-9; 2-G-5 
OVERLAY macro 2-11-13 
Override error condition 2-6-6 
OVL record type 2-G-5 
OWN parameter 2-2-12 
OWNCODE address 2-2-13 
026 mode 2-3-19; 2-4-6 
029 mode 2-3-19; 2-4-6 



Pack name 2-2-14,16; 2-5-2,11; 
2-6-21,22,27,28; 2-C-9 

(Packed date 2-9-2,4 
Packed time 2-9-3,4 
PACKNAM macro 2-6-21,22; 2-A-3 
Parameter 2-C-9 

Parameters, control statement 2-E-2 
Parameters, RA+1 call 2-1-2 
Parity 2-C-9 

Parity errors 2-3-3,25; 2-6-6 
PARITY macro 2-12-16; 2-A-2 
Parity, terminal 2-12-16 
Password 

Changing 2-5-32 

Defined 2-C-9 

File 2-2-14,16; 2-5-2,32 
PCET error 2-6-6 
I PDATE macro 2-9-2 
PEET error 2-6-6 
Pending interrupts 2-10-9 
Pending RA+1 requests 2-10-9 
Peripheral processor (refer to PP) 
Permanent file 

Backup requirement 2-5-2 

Catalog 2-5-16; 2-C-9 

Defined 2-C-9 

Devices 2-5-11 

Direct access 2-5-26,31 

Family 2-C-9 

Indirect access 2-5-12,24 

Information 2-5-16 

Manager (refer to PFM) 

Name 2-2-14,15; 2-5-1 

Name, changing 2-5-32 

Parameters 2-6-28 

Permission 2-5-8,22 

Preferred residence 2-5-2,10 

Purging 2-5-15 

Real-time processing 2-5-1 



Releasing 2-4-5 

Returning 2-3-40,46 

Subsystem 2-5-2 

Type 2-E-6 
Permission, file 2-5-8,22 
Permission information 2-5-16,22 
Permission modes 2-4-26; 2-5-8 
Permit entry error 2-5-18 
PERMIT macro 2-5-22 
PFM 

Common decks 2-5-1,3,8 

Error codes 2-5-3 

FET format 2-5-1 

Parameter 2-2-14 

Registers used 2-5-2 

Request 2-5-1 
PFN parameter 2-2-14,16 
PGNR symbol 2-1-8; 2-E-2 
PHFT type files 2-E-5 
Physical record unit (refer to PRU) 
PKN parameter 2-2-14,16 
Plotter 2-8-2 
PMFT type files 2-E-6 
Positioning a file 2-3-36 
Positioning the control statement file 
2-4-14 

POSMF macro 2-3-41 
PP 

Abort 2-6-6 

Absolute overlay 2-G-l 

Activity 2-6-26 

Call error 2-6-6 

Defined 2-C-lO 

Record type 2-G-5 
PPET error 2-6-6 
PPTEXT fUe 2-1-6 
PPU record type 2-G-5 
Preferred residence 2-5-2 
PRFT type files 2-E-5 
PRIMARY macro 2-4-24; 2-A-2 
Primary terminal file 

Creation 2-4-24; 2-5-36 

Defined 2-C-lO 

Returning 2-3-40 

Type 2-E-6 
Print file 

Define 2-C-lO 

Releasing 2-4-5 

Returning 2-3-40 

Type 2-E-5 
Priority, CPU 2-6-2,13 
Priority, queue 2-6-1,13 
Private auxiliary device 2-C-lO 
Private file 2-5-9 
PROC record 2-11-17; 2-G-5 
Procedure records 2-11-17; 2-G-5 
Processing options, tape 2-4-16,29 
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Processing tape requests 2-3-13,14; 
2-4-15 
Program 

Address 2-E-4 

Control of terminal activity 2-12-4 

Error exit mode 2-6-2; 2-E-4 

Library 2-C-lO 

Parameter area 2-1-8; 2-E-2 

Status designator register (refer to 
PSD) 

Stop 2-6-6 

Termination 2-11-4 

Text documentation 2-1-8 
Program /system communication 2-2-1 
PROMPT macro 2-12-17; 2-A-2 
PROTECT macro 2-6-32; 2-A-3 
PRU 

Defined 2-C-lO 

Magnetic tape 2-J-l 

Mass storage 2-2-9 

Reading 2-3-22 

Size 2-2-9; 2-3-25; 2-4-19; 2-J-l 

Writing 2-3-30 
PSCSF macro 2-4-14.1; 2-A-2 
PSD register 2-E-5 
PSET error 2-6-6 
Psuedo instruction 2-C-lO 
Psuedo-sense switches 2-6-12; 2-E-2 
PSSTEXT file 2-1-6 
PTAP mode 2-5-8 
PTEX mode 2-5-8 
PTFT type files 2-E-6 
PTMD mode 2-5-8 
PTNU mode 2-5-8 
PTRA mode 2-5-9 
PTRD mode 2-5-8 
PTRM mode 2-5-9 
PTWR mode 2-5-8 
Public auxiliary device 2-C-lO 
Public file 2-5-9 
Punch file 

Defined 2-C-lO 

Releasing 2-4-5 

Returning 2-3-40 

Type 2-E-5 
PUNCHB 2-4-6 
PUNCH9 2-4-6 
PURGE macro 2-5-15 
Purging files 2-5-15 
P WD parameter 2-2-14,16 
P8 2-4-6 



QFM request 2-7-1 

QUAL pseudo instruction 2-1-14 

QUAL$ tag 2-1-14 

Qualified symbol 2-C-lO 



Qualif yi ng com m on de cks 2-1-14 
Queue 

Device assignment 2-7-5 

File manager 2-7-1 

Priority 2-6-1,13; 2-C-ll 

Protection 2-7-1 

Rollout 2-6-9 

Type fUes 2-E-5 



RA 2-C-ll; 2-E-l,4 
RA+1 requests 2-1-4 
RA.CEJ symbol 2-1-8 
RA.CMU symbol 2-1-8 
RAE 2-C-ll; 2-E-5 
RA.MTR symbol 2-1-8 
Random 

Access 2-3-4,9; 2-C-ll 

Access bit 2-2-6 

Address 2-3-3; 2-4-21 

File 2-C-lO 

File, sample 2-H-l,7 

Index 2-2-9; 2-3-3 

1/0, examples 2-H-l 

Processing 2-3-4 

Request 2-2-10; 2-3-9 

Rewrite request 2-2-10; 2-3-3 
RCL request 2-11-10 
READ function 2-3-11 
Read functions 2-3-22 
READ macro 2-3-23 
Read/write, ECS 2-D-l 
Read/write interlock 2-5-31 
Read/write, random 2-3-9 
READC macro 2-3-53 
RE ADC W macro 2-3-24 
READEI macro 2-3-29 
READH macro 2-3-54 
Reading ANSI labels 2-3-14; 2-4-15 
Reading labels 2-3-13,14; 2-4-15 
READLS macro 2-3-26 
READN macro 2-3-28 
READNS macro 2-3-28 
READNR function 2-3-11 
READO macro 2-3-54 
READS macro 2-3-55 
READSKP macro 2-3-24 
READW macro 2-3-56 
Real-time clock 2-9-5 
Real-time processing 2-5-31 
Real-time processing bit 2-2-15; 
2-5-1,32 

Recall 2-1-3; 2-C-lO 
RECALL macro 2-11-10 
Record manager I/O 2-3-57 
Record types 2-G-5 
Records, skipping 2-3-46,48 
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RECOVR macro 2-10-11; 2-A-3 

Reel (refer to Volume) 

REEL function 2-3-11 

REELNR function 2-3-11 

Reference address (refer to RA) 

Register 2-C-ll 

Registers, job control 2-6-16,17,31 

Registers, restoring 2-10-6; 2-12-12 

REL record type 2-G-5 

Relative address 2-C-ll 

RELEASE macro 2-4-5 

Releasing 

File space 2-4-5 
Files to output queues 2-4-6 
Job attachment 2-3-40,46 
Local files 2-4-5; 2-7-1 
I Memory 2-11-6 

Relocatable assembly 2-C-ll 

Relocatable record type 2-G-5 

Remote batch origin type 2-E-6 

Removable device 2-C-ll 

RENAME macro 2-4-2 

Renaming a file 2-4-2 

REPLACE macro 2-5-24 

Replacing files 2-5-24 

REPRIEVE macro 2-10-10; 2-A-3 

Reprieve processing 2-10-6 

Request code 2-2-6; 2-3-2 

REQUEST macros 2-4-9,11 

Request processor 2-1-1 

Request/return codes 2-2-6; 2-3-2 
I Requests, system 2-1-2; 2-11-1 

RERUN macro 2-7-2; 2-A-2 

Rerun status 2-7-2 

Reset function 2-10-6 

Residency, file 2-5-11,26 

Restarting a job 2-10-3 

Resume function 2-10-6 

Retention cycle 2-2-11 

Return code 2-2-6 

RETURN 

Function 2-3-18 

Macro 2-3-40 

vs EVICT macros 2-3-46 

vs UNLOAD macros 2-3-40 

Returning a pack 2-3-40 

Returning a tape file 2-3-40 

REWIND function 2-3-18 

REWIND macro 2-3-37 

Rewinding a file 2-3-37 

REWRITE macro 2-3-33 

REWRITEF macro 2-3-35 

RE WRITER macro 2-3-34 

RFILEB macro 2-2-12 

RFILEC macro 2-2-12 

RFL request 2-11-6 

RFL= entry point 2-F-2 

RMS 2-C-12 



ROFT files 2-E-5 
Rollout 

Control 2-6-9 

Defined 2-C-12 

FUe 2-C-12 

File type 2-E-5 

Queue 2-6-9 

Time period 2-6-10 
ROLLOUT macro 2-6-9; 2-A-2 
Rotating mass storage (refer to RMS) 
ROUTE macro 2-8-4 
Routing files 2-8-4 
RPHR macro 2-3-22 
RPHRLS macro 2-3-27 
RPV request 2-10-6 
RRET error 2-6-6 
RTIME macro 2-9-5 
Running field length 2-6-16,20; 2-11-6 



S fcx-mat tape 

Defined 2-J-4 
Reading 2-3-28 
Writing 2-3-35 
SAVE macro 2-5-12 
Saving a fUe 2-5-12,24 
SDM= entry point 2-F-2 
Sector 2-C-12 

Security considerations 2-1-16 
Security count 2-7-4; 2-C-12 
Secure system memory 2-1-16; 2-6-11; 

2-F-2 

Semiprivate files 2-5-9 
Sense switches 2-6-12,31; 2-C-12; 

2-E-2 

Sequence error 2-4-2 
Sequential access 2-3-4; 2-C-12 
Sequential file 2-C-12 
Set identification 2-2-11; 2-4-20; 

2-J-8 

Set, magnetic tape 2-3-41 
SETASL macro 2-6-2.1/2-6-2.2; 2-A-3 
SETFET macro 2-2-14; 2-A-3 
SETGLS macro 2-6-24 
SETID macro 2-4-12 
SETJCI macro 2-6-32; 2-A-3 
SETJCR macro 2-6-17; 2-A-2 
SETJSL macro 2-6-3;. 2-A-3 
SETLC macro 2-6-15; 2-A-2 
SETLOF macro 2-6-30; 2-A-3 
SETMFL macro 2-6-27; 2-A-3 
SETPR macro 2-6-2; 2-A-2 
SETQP macro 2-6-1; 2-A-2 
SETRFL macro 2-6-16; 2-A-3 
SETSS macro 2-6-18; 2-A-2 
SETSSM macro 2-6-10; 2-A-2 
SETTL macro 2-6-4; 2-A-3 
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Setup function 2-10-6 

Short PRU 2-C-12 

SI tape format 2-4-19; 2-J-l,3 

SKIPB macro 2-3-48 

SMPEI macro 2-3-48 

SKIPF macro 2-3-46 

SKIPFB macro 2-3-49 

SKIPFF macro 2-3-47 

Special entry point 2-C-12; 2-F-l 

Special error flag 2-6-6 

SPET error 2-2-7; 2-6-6 

SPPR symbol 2-1-8; 2-E-2 

SRET error 2-6-6 

SRU 

Account block 2-6-2,10 

Accumulated 2-11-13 

Defined 2-C-12 

Job step 2-6-3,10 

Limit error 2-6-6 
SSET error 2-6-6 
SSJ= entry point 2-F-2 
SSM status 2-F-2 
SSM= entry point 2-F-2 
Standard label processing 2-2-7; 

2-3-9,41 
Standard labeled tape 2-C-12 
Status information, CIO 2-3-2 
STATUS macros 2-4-7 
Status of terminal 2-12-17 
STIME macro 2-9-5 
SUBMIT macro 2-7-3; 2-A-2 
Submitting jobs 2-7-3; 2-8-1 
SUBR macro 2-11-11; 2-A-2 
Subsystem abort error 2-6-6 
Subsystem control 2-6-18,22 
Subsystem type 2-5-10; 2-12-18 
SYET error 2-6-6 
SYFT type files 2-E-6 
Symbol 2-C-12 

Symbols, system communications 2-1-8; 
2-E-2 
SYOT 2-E-6 
SYSCOM macro 2-1-8 
SYSLIB 2-1-9; 2-A-6; 2-C-12 
System 

Abort 2-6-6; 2-7-2 

Communication symbols 2-1-8; 2-E-2 

Default library 2-1-9 

File manager (refer to SFM) 

File, return 2-3-40 

Files 2-C-13; 2-E-6 

Library 2-1-9; 2-A-6; 2-C-12 

Origin type 2-E-6 

Request processing 2-1-3 

Requests 2-1-2; 2-11-1,11; 2-C-13 

Resource units (refer to SRU) 

Text 2-C-13 

Type file, returning 2-3-40 



System activity infca-mation 2-6-26 
SYSTEM macro 2-11-11 
System texts 2-1-6; 2-C-13 
SYSTEXT file 2-1-6 



*T directive 2-1-7 
Tape 

Block size 2-4-19,28; 2- J-1 

Conversion mode 2-4-16,28 

Density 2-4-16,28 

Formats 2-4-19,28; 2-C-13; 2-J-l 

Label processing 2-3-13,14 

Mark 2-C-13 

Noise 2-4-19,29; 2-J-l 

Processing options 2-4-16,29 

Requests 2-3-13,14; 2-4-15 
Tape f Ues (refer to Magnetic tape files) 
TCS request 2-10-1 
TEFT file 2-E-5 
Temporary file 2-C-13 
Terminal 

Buffer sizes 2-2-13 

Carriage control 2-12-5,8 

Class 2-12-9,18 

Identification 2-8-3 

Input prompt 2-12-17 

Output problems 2-12-2 

Parity 2-12-16 

Print position 2-12-4 

Redefinition 2-12-9 

Status 2-12-17 

Suspended 2-12-11,12 
Termination, program 2-11-4 
Termination sequence 2-12-11 
Text format 2-G-8 
TID code 2-8-3 
TIM request 2-9-1 
Time, accumulated CPU 2-9-3,6 
Time limit 

Error 2-6-6 

Read 2-6-14 

Set 2-6-4 
TIME macro 2-9-6 
Time of day 2-9-1,4 
Time-sharing origin type 2-E-6 
Time-sharing terminal, buffer sizes 
2-2-13 

Time slice 2-C-13 

Timed/event rollout file 2-C-13; 2-E-5 
TKET error 2-6-6 
TLET error 2-6-6 
Track limit error 2-3-3; 2-6-6 
Track mode 2-4-15 
Tracks bit 2-4-15 
Transaction subsystem 2-12-18 
Transfer address 2-10-9 
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Translate control statements 2-10-1 
Transmission code 2-12-19 
Transparent mode 2-12-6,7 
TSTATUS macro 2-12-17; 2-A-2 
TXOT 2-E-6 



UCW parameter 2-2-14,16 
ULIB record type 2-G-6 
Unlabeled tape 2-3-13; 2-4-15; 2-C-13 
UNLOAD function 2-3-18,21 
UNLOAD macro 2-3-38 
2-4-7 

2-2-10; 2-3-3,25,29,36 
2-2-13 
2-6-19 



UNLOCK macro 
Unused bit count 
UPR parameter 
USECPU macro 
User 
I Control point dayfile 2-11-1 

Control word 2-2-14,16; 2-5-2,17 
I DayfUe 2-11-1 

File privacy 2-6-32 

Index 2-6-15,28; 2-C-13 

Label buffer 2-3-16,43 

Libraries 2-G-6 

Number 2-6-19,28 

Number, alternate 2-2-14,16; 
2-5-2,7 

Permission 2-5-8,22 

Processing 2-2-6,13 

Processing bit 2-2-6,13,15; 2-5-1 
USERNUM macro 2-6-19 
USN parameter 2-2-14,16 



Word 2-C-14 

Working buffers 2-3-50 

Working storage 2-2-10,13 

WPHR macro 2-3-30 

WRIF$ symbol 2-3-32 

WRITE function 2-3-11 

Write functions, CIO 2-3-30 

Write lockout bit 2-4-7 

WRITE macro 2-3-30 

Write ring 2-C-14 

WRITE C macro 2-3-53 

WRITECW macro 2-3-32 

WRITEF macro 2-3-31 

WRITE H macro 2-3-54 

WRITEN macro 2-3-35 

WRITE NR function 2-3-11 

WRITEO macro 2-3-55 

WRITER macro 2-3-31 

WRITES macro 2-3-55 

WRITE W macro 2-3-56 

Writing ANSI labels 2-3-14; 2-4-15 

Writing interactive programs 2-12-1 

Writing labels 2-3-13,14; 2-4-15 

WSA parameter 2-2-13 



XJ instruction 2-1-5 

XJPR symbol 2-1-5,8; 2-E-2 

XJR request 2-12-14 

XL parameter 2-2-13 

XTEXT common deck call 2-1-10,12 



VAL= entry point 2-F-2 

Validation file 2-C-13 

VERSION macro 2-6-23; 2-A-3 

Volume 2-C-13 

Volume serial number 2-4-19 

VOLl 2-3-16; 2-4-19 

VSN 2-4-19; 2-C-13 



Zero byte terminator 2-C-14 
Zero length PRU 2-C-14 



580 PFC 2-8-3 

6681 function reject error 



2-3-3 
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